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LOGITECH Software License Agreement 


THIS DOCUMENT IS A LEGAL AGREEMENT BETWEEN YOU, THE LICENSEE, AND 
LOGITECH, INC ("LOGITECH"). By USING THIS PROGRAM, YOU ARE AGREEING 
TO BECOME BOUND BY THE TERMS OF THIS AGREEMENT. IF YOU DO NOT AGREE TO 
THE TERMS OF THIS AGREEMENT, PROMPTLY RETURN THE DISK PACKAGE AND THE 
OTHER ITEMS THAT ARE PART OF THIS PRODUCT IN THEIR ORIGINAL PACKAGE, WITH 
YOUR PAYMENT RECEIPT (THE "RECEIPT"), TO LOGITECH FOR A FULL REFUND. 


In consideration of payment of the License Fee, which is a part of the price 
evidenced by the Receipt, LOGITECH grants to the Licensee a nonexclusive 
right, without right to sublicense, to use this copy of this LOGITECH Software on 
a single Computer at a time. LOGITECH reserves all rights not expressly 
granted, and retains title and ownership of the Software, including all subsequent 
copies in any media. This Software and the accompanying written materials are 
copyrighted. You may copy the Software solely for backup purposes; all other 
copying of the Software or the written materials is expressly forbidden. 


As the only warranty under this Agreement, and in the absence of accident, abuse 
or misapplication, LOGITECH warrants, to the original Licensee only, that the 
disk(s) on which the Software is recorded is free from defects in materials and 
workmanship under normal use and service for a period of ninety (90) days from 


the date of payment as evidenced by a copy of the Receipt. LOGITECH’s only 
obligation under this Agreement is, at LOGITECH’s option, to either (a) return 
payment as evidenced by a copy of the Receipt or (b) replace the disk that does 
not meet LOGITECH’Ss limited warranty .and which is returned to LOGITECH 
with a copy of the Receipt. THIS WARRANTY GIVES YOU LIMITED, SPECIFIC LEGAL 
RIGHTS. YOU MAY HAVE OTHER RIGHTS, WHICH VARY FROM STATE TO STATE. 


THE SOFTWARE AND ACCOMPANYING WRITTEN MATERIALS (INCLUDING THE 


USER’S MANUAL) ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND 
INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 


PARTICULAR PURPOSE, EVEN IF LOGITECH HAS BEEN ADVISED OF THAT PURPOSE. 
LOGITECH SPECIFICALLY DOES NOT WARRANT THAT THE OPERATION OF THE 


SOFTWARE WILL BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL OR 
INCIDENTAL DAMAGES ARISING OUT OF THE USE OF OR INABILITY TO USE SUCH 


PRODUCT EVEN IF LOGITECH HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH 
DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF 
LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES, SO THE ABOVE 
LIMITATION MAY NOT APPLY. 


LOGITECH Limited Lifetime Hardware Warranty 


Non-Transferrable 


LOGITECH mice and mouse boards are warranted to be free from failures due to 
defects in material and workmanship for as long as you own them. During the 
first two years, LOGITECH will, at its sole option, replace or repair at no charge 
the product which, in its opinion, is defective. 


During the remaining years of the warranty, LOGITECH will, at its sole option, 
replace or repair the defective product, LOGITECH will charge you a fixed fee to 
cover handling and service costs based on LOGITECH’s then current price 
schedules. LOGITECH, at its sole option, may replace or repair the defective 
product with a then-current product having similar features and functionality as 
determined by LOGITECH. 


You are responsible for packing the failed product properly for shipment, and for 
the charges to ship the failed product to LOGITECH, and LOGITECH is 
responsible for charges to ship the repaired or replacement product. If any charge 
to you is involved, the replacement product will be sent C.O.D. 


If the failed product has been modified without LOGITECH’s consent or if the 
failure is the result of misuse, abuse or misapplication, LOGITECH has no 
obligation to repair or replace the failed product. 


Before returning a failed unit, you must obtain a Return Merchandise 
Authorization (RMA) number by calling LOGITECH Customer Service: in the 
U.S., phone (800) 231-7717; in California call (800) 552-8885. The RMA 
number should be prominently displayed on the outside of the returned package 
and on the accompanying packing list. LOGITECH cannot be held responsible 
for any package returned without an RMA Number. 


EXCEPT AS EXPRESSLY PROVIDED ABOVE, THE HARDWARE AND ACCOMPANYING 
WRITTEN MATERIALS (INCLUDING THE USER’S MANUAL) ARE PROVIDED "AS IS" 
WITHOUT WARRANTY OF ANY KIND, INCLUDING THE IMPLIED WARRANTIES OF 
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, EVEN IF 
LOGITECH HAS BEEN ADVISED OF THAT PURPOSE. IN NO EVENT WILL 


LOGITECH BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL OR 
INCIDENTAL DAMAGES ARISING OUT OF THE USE OF OR INABILITY TO USE SUCH 


PRODUCT EVEN IF LOGITECH HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH 
DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF 
LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES, SO THE ABOVE 
LIMITATION MAY NOT APPLY. 


PLEASE RETURN THE ENCLOSED REGISTRATION CARD FOR YOUR WARRANTY TO BE 
VALID. WARRANTY CLAIMS MAY NOT BE HONORED IS THERE IS NO 
CORRESPONDING REGISTRATION CARD ON FILE AT LOGITECH, INC. 


Notes: 


The LOGITECH Mouse 


IMPORTANT 


See the READ.ME file on Disk 1 for late breaking news about this version of 
LOGITECH Mouse Software. 
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Introduction 


Traditionally, the mouse has been used as a pointing device by CAD, PAINT, and other 
graphics-oriented applications. Many software developers, recognizing the flexibility 
and immediacy of the mouse as a productivity tool, are now building applications in non- 
graphics business and creative environments as well, with applications ranging from data 
base and spreadsheet management on through telecommunications and desktop 
publishing. 


Recognizing the importance of the expanded uses for the mouse, LOGITECH Mouse 
software has also been designed to be able to emulate cursor keys and implement 
keyboard macros for your favorite non-mouse applications. 
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What have you purchased? 


This manual tells you how to work with the range of LOGITECH Mice, including the 
LOGITECH Serial Mouse, Bus Mouse, and the LOGITECH Series 2 Mouse. 


The LOGITECH Serial Mouse 


The LOGITECH Serial Mouse Package consists of: 


The LOGITECH Serial Mouse 

A 9- to 25 pin adapter. 

LOGITECH Mouse driver software on 5 1/4" disk. 
LOGITECH Mouse Plus software on 5 1/4" disk. 
The LOGITECH Mouse User’s Manual, 

the manual you are now reading. 


The LOGITECH Bus Mouse 


The LOGITECH Bus Mouse Package consists of: 


The LOGITECH Bus Mouse. 

The Bus Board. 

LOGITECH Mouse driver software on 5 1/4" disk. 
LOGITECH Plus software on 5 1/4" disk. 

The LOGITECH Mouse User’s Manual, 

the manual you are now reading. 


The LOGITECH Series 2 Mouse 


The LOGITECH Series 2 Mouse Package consists of: 


The LOGITECH Series 2 Mouse. 

LOGITECH Mouse Driver software and Plus software on a 3 1/2" disk. 
The LOGITECH Mouse User’s Manual, 

the manual you are now reading. 
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Other LOGITECH Products 


At LOGITECH we pride ourselves on technical excellence and advanced engineering. 
We also offer these fine products, which we believe to be the most advanced in their 
product category. 


LOGITECH Mouse Programmer’s Toolkit (with software) 


Contains information and guidelines for programmers who wish to develop 
applications using the mouse and the standard mouse driver. Programming 
interfaces are provided for Assembler, BASIC, C, Modula-2, and Pascal. 


Note: The Programmer’s Toolkit does not address the problem of 
interfacing the mouse directly through the serial port. 


LOGITECH Mouse Technical Reference Manuals 


Contain details about the LOGITECH Mouse electrical interface, data formats, 
baud rates, and report rates. 


LOGITECH Modula-2 
LOGITECH Modula-2 offers these Modula-2 functions: 


e The LOGITECH Modula-2 base package, with tutorial, complete library 
listings, and a post-mortem debugger, and a compiler that generates standard 
DOS linker compatible .OBJ files. 

@ The LOGITECH Modula-2 Toolkit, with the full-featured LOGITECH 
Linker and a full complement of utilities to help you manage the 
development and revision of your LOGITECH Modula-2 programs. 

@ The Turbo-Pascal To LOGITECH Modula-2 Translator. 

@ A VAX/VMS version of LOGITECH Modula-2. 


Site licenses are available for all LOGITECH Modula-2 products. 


For additional sales information, or to order these products, call the LOGITECH sales 
office toll-free from anywhere in the continental U.S. at (800)231-7717, or 
in California, call (800) 552-8885. 
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How to Read This Manual 


The following conventions are used in this manual: 


Keys to be pressed, look like this: 
Control sequences or characters entered with a Control or Shift key, look like this: 
Keys from the Numeric Keypad are shown like this: 
(-) 
Keyboard input for the DOS Command line is in upper case and looks like this: 
CLICK 
Mouse buttons used are based on the LOGITECH standard, and use three buttons, e.g, 


means press the left mouse button, 
means press the right mouse button, and 
means press the middle mouse button. 


(mm) means press both buttons on a two button mouse. 


Variable names in the text are surrounded by angle brackets, as in 


File names look like this: 
MENU.EXE AUTOEXEC.BAT 


DOS commands and statements look like this: 
PATH, COPY 


Product names look like this: 


LOGITECH Series 2 Mouse, DOS, Point & Click Shell 
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Reserved words and user-defined functions in LOGIMENU code look like this when 
being discussed in the text: 


CHORDS, BEGIN, MyFunction 


These are not emphasized in screen display or program listings. 


Screen output and some listings look like this when being discussed in the text: 
Program Not Found 


These are not emphasized in screen display or program listings. 


LOGIMENU and other code listings look like this: 


BEGIN LeftB, MidB, RightB, LeftM, RightM, UpM, DownM, 50, 100 


LeftB: TYPE ENTER 
MidB: TYPE 3 : 3 is CTRL-C 
RightB: TYPE ESC 


LeftM: TYPE 0, 75 ; 0, 75 is Left Arrow Key 
RightM: TYPE 0, 77 ; 0, 77 is Right Arrow Key 
UpM: TYPE 0, 72 ; 0, 72 is Up Arrow Key 

DownM: TYPE 0, 80 ; 0, 80 is Down Arrow Key 


Sample Screens look like this: 


open close HELP @next prev @#WINDOW EDITING MOVING QUIT+ETC OPTIONS TOPLIST 


POINT Editor Version n.n Copyright 1987 LOGITECH Inc. All Rights Reserved 
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How this User’s Manual is Organized 


This manual assumes that you are somewhat familiar with the basics of DOS and with 
basic programming concepts and terminology. 


Beside this general introduction, this manual has four main divisions, or books: 


An installation guide for the full LOGITECH Mouse line. 

A user’s guide to LOGITECH PLUS software 

A user’s guide to M123, the Point & Click Shell. 

The POINT Editor User’s Manual, with tutorial and reference chapters. 


Each book/division is self-contained, with its own Table of Contents and Index. To 
switch between books quickly, flex the manual to locate the black line where each 
division begins. 


Similarly, the pages in each division have a simple prefix at the bottom of each page, as 
follows: 


A-n__ identifies the Installation division. 

B-n_ identifies the LOGITECH Plus Software division. 
C-n__ identifies the M123, Point & Click Shell division. 
D-n__ identifies the POINT Editor division. 
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Introduction 


The LOGITECH Mouse can be used directly with most applications or can be easily 
programmed to work with others. 


LOGITECH Mouse software configures your mouse for different software applications 
and helps you build time-saving pop-up menus for those applications. 


LOGITECH Mouse drivers work with all applications that use the Microsoft mouse 
driver. 


Your LOGITECH Mouse is programmable. This means that, in addition to using your 
mouse with most mouse-based applications, you can use it with ordinary keyboard cursor 
based programs to move a point or cursor on your computer screen; the mouse buttons 
can then be used to position data, create graphics, or select, copy, and edit text. 


And because it’s programmable, your LOGITECH Mouse also works with virtually any 
application. 
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Notes: 
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Chapter 1 
LOGITECH Mouse Installation 


This chapter tells you how to install your LOGITECH Mouse in an IBM PC/XT/AT 
or compatible computer. 
Section 1.1 covers the LOGITECH Serial Mouse, which plugs into a serial port. 


Section 1.2 covers the LOGITECH Bus Mouse, which plugs into the bus board 
and frees up your serial port. 


Section 1.3 covers the LOGITECH Series 2 Mouse, which plugs into the mouse 
port on your JBM PS/2 computer. 


Section 1.4 shows you how to hold the mouse for maximum ease of use. 
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1.1 The LOGITECH Serial Mouse 


1.1.1 General Description 


In addition to working with all applications that use the Microsoft mouse driver, the 
LOGITECH Serial Mouse emulates other computer mice, including the earlier 
LOGITECH C7 Mouse, the Mouse Systems Corporation PC Mouse, the Torrington 
Manager Mouse, and the Visi-On Mouse. This means that, even if an application 
doesn’t list your LOGITECH Serial Mouse in the installation menu, if it lists one of 
these other mice, your LOGITECH Serial Mouse will work. 


Figure A-1 LOGITECH Serial Mouse, 9-Pin Connector, and 9- to 25- Pin Adapter 
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1.1.2 System Requirements and Compatibility 


Your LOGITECH Serial Mouse is designed for use with IBM PC/XT/AT or compatible 
computers. It connects to your microcomputer system through a 9- pin or 25- pin 
RS-232 serial port configured to COM1 or COM2. You can use with either a dual 
floppy disk system or one with one or more floppy disk drives and a hard disk. 


1.1.2.1 System Requirements 


Here are the system requirements for the LOGITECH Serial Mouse: 


Personal 
Computer 


Drives 
Memory 


Graphics 
Adapter 
Cards 


Serial Port 
Operating 
System 


IBM PC, XT or AT, 

IBM PS/2, Model 30, 50, 60, 80 (through the serial port) 
or other 100% IBM PC compatibles 

Two disk drives, or a hard disk and at least one disk drive 
256 K of RAM 


IBM Monochrome Adapter 

IBM Color Graphics Adapter 

IBM Enhanced Graphic Adapter with Enhanced Color Monitor or 
compatibles. 


COMI1 or COM2 


IBM PC DOS or MS-DOS 2.0, or later 
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1.1.2.2 LOGITECH Serial Mouse Compatibility 


The LOGITECH Serial Mouse driver works like the Microsoft Mouse driver with all 
application programs that use the Microsoft Mouse. MOUSE.COM and MOUSE.SYS 
from LOGITECH are functionally compatible with files of the same name from 
Microsoft for the Microsoft Mouse. Applications that use the Microsoft driver usually 
refer to it as the Microsoft Mouse driver, the Microsoft compatible mouse driver, ot as 
MOUSE.COM. 


When you set your mouse driver to the appropriate protocol (5b) and baud rate (1200), 
your LOGITECH Serial Mouse is fully compatible with PC Mouse from Mouse 
Systems Corporation, Visi-On Mouse, and Torrington Manager Mouse. 


1.1.2.3 Connector Pin Assignments 


LOGITECH Serial Mouse comes with a standard RS-232C subminiature female 
connector compatible with the IBM AT, and with a 9- to 25 pin adapter to make it 
compatible with the IBM PC/XT. 


Here are the connector pin assignments for the 9- to 25 pin adapter. 


25-pin Connector Data Signals 9-pin Connector 


Protective Ground 

Receive Data (To Mouse) 
Transmit Data (From Mouse) 
Request to Send 

Clear to Send 

Data Set Ready 

Signal Ground 

Data Terminal Ready 


1 
2 
3 
4 
5 
6 
7 
20 


Figure A-2 9-to25-Pin Adapter Pin Assignments 
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1.1.3 Install your LOGITECH Serial Mouse 


Your LOGITECH Serial Mouse has a 9-pin RS-232 connector for IBM AT 
compatibles, and a 9- to 25-pin adapter for connection to IBM PC/XT compatibles. 
The procedure to attach either connector to the computer is the same: 


Step 1: 
Step 2: 


Step 3: 


Switch your computer OFF and unplug all peripheral equipment. 


Locate the RS-232 Serial Port Connector 1 or 2 on the back of your computer. 
Refer to the owners manual for your computer and/or to any documentation for 
your add-in boards. This will normally be a "male" connector with pins sticking 
out from the computer. Gently press the mouse connector into place and 
tighten the screws. 


NOTE 
Your LOGITECH Serial Mouse also works with a converter cable, 


either 25- to 9-pin or 9- to 25-pin. 


Get ready to turn on your computer. 


Reconnect any peripheral equipment and close your computer. If you had your 
computer open, (to install a serial card etc.) close it and reconnect any peripheral 
equipment. You are now ready to turn on your computer, install your mouse 
driver software, and put your mouse to work. 


If this is the first time you’ve used a mouse turn first to Section 1.4, How to 
Hold Your Mouse. If you are already familiar with a mouse product, turn to 
Book 2, LOGITECH Plus Software, for instructions on setting up your system 
to work with the LOGITECH Plus software that comes with your LOGITEC 
Mouse. 
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1.2 The LOGITECH Bus Mouse 


DB-9 Female 
Connector* 


Figure A-3 LOGITECH Bus Mouse, Bus Board, and Two Connector Types 
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1.2.1 General Description 


The LOGITECH Bus Mouse supports all applications that use the Microsoft Mouse 
driver. In addition, it can be programmed to use all three buttons for most applications 
that do not specify their own mouse interface. 


1.2.2 System Requirements and Compatibility 


Your LOGITECH Bus Mouse is designed for use with computers that are 100% IBM 
PC/XT/AT, and IBM PS/2 (Model 30) compatible computers. It connects to your 
microcomputer system through a printed circuit board with either a 9-pin D-Ring, 
or 9-pin Mini-DIN circular connector. 


1.2.2.1 System Requirements 
Here are the system requirements for the LOGITECH Bus Mouse: 


Personal IBM PC, XT or AT, 


Computer IBM PS/2, Model 30 
or other 100% IBM compatibles 


Drives Two floppy drives, or one floppy and a hard disk. 
Memory 256 K of RAM 
Graphics IBM Monochrome Adapter 
Adapter IBM Color Graphics Adapter 
Cards IBM Enhanced Graphic Adapter 
with Enhanced Color Monitor or compatibles. 
Expansion An open Slot for the Bus Board. 
Operating 
System PC DOS or MS-DOS 2.0, or later 


1.2.2.2 LOGITECH Bus Mouse Compatibility 


The LOGITECH Bus Mouse driver works like the Microsoft Mouse driver with all 
application programs that use the Microsoft Mouse. MOUSE.COM and MOUSE.SYS 
from LOGITECH are functionally compatible with files of the same name from 
Microsoft for the Microsoft Mouse. Applications that use the Microsoft driver usually 
refer to it as the Microsoft Mouse driver, the Microsoft-compatible mouse driver, or as 
MOUSE.COM. 
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1.2.3 How to Install Your LOGITECH Bus Mouse 


Your LOGITECH Bus Mouse has two components to install: a Bus Board and a Mouse. 
First, install the Bus board; then, connect your mouse. 


1.2.3.1 Configure Your Bus Board 


Step 1: Remove the Bus Board from its Antistatic Protection Packaging 


The Board is shipped in this packaging for protection from static electricity. To 
protect the Bus Board while you are installing it in your computer, avoid manual 
contact with electrostatic substances such as plastic or styrofoam. 


Step 2: Find the position of the Bus Board components. 


ZO zz 


23 45 


Jump 1 (IRQ Jumper) 
aaa a 
aE $d 


Figure A-4 LOGITECH Bus Board with Typical Jumper Setting 
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Step 3: Set the Jumpers on your Bus Board. 


Set the jumper on your Bus Board to be compatible with your computer. 
The following tables show correct settings for the type of computer you have: 


Computer Don’t use 


Optional Settings 


Here are the interrupts that can be used by the LOGITECH Bus Mouse. 
Notice: IRQ3 is normally used by COM2, and IRQ4 by COM1. Avoid 
these interrupts if you are using either COM port on your computer. 


Interrupt Setting IBM AT IBM PC/XT 


extended interrupt unused 
COM 2 COM 2 


COM 1 COM 1 
Printer #2 Fixed Disk 


The Bus Board is set at I/O address 23C to 23F. 


Determine the correct configuration for your computer. Then place the jumper 
clip on the appropriate pin pair for your system, as shown in Figure A-4, above. 
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1.2.3.2 Install Your Bus Board 


After you set the jumper, install the Bus Board in the expansion slot in your computer. 


Before you install your LOGITECH Bus Board you must prepare your computer. 


Step 1: 


Step 2: 


Step 3: 


Step 4: 


Turn your computer OFF. 

Make sure the system unit power switch is OFF. To be sure, disconnect the 
power cord and all other cables from the back of your system unit. 

Remove the cover from your system unit. 


Consult the user manual for your computer on installing add-in boards. 


Locate a free expansion slot in your computer. 

If you are not sure which slot to use, consult the user manual for your computer. 
For example, slot 8 is reserved on the IBM PC/XT. 

Insert the Board in your computer. 


Make sure that the gold-striped bottom edge of the Board sits firmly in the 
expansion slot groove and that the bracket of the Board is in the groove which 
previously held the slot cover. 
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1.2.3.3 Connect Your Mouse 
To connect the LOGITECH Bus Mouse to your Bus Board: 


Step 1: Check to make sure that the the computer is OFF 


Step 2: Secure mouse cable connection. 


Locate the 9-pin connector on the back of your Bus Board and gently press the 
Bus Mouse connector in place. 


If you have a D-ring connector, tighten the screws on the sides of the cable 
connector to secure it. 


If you have a circular Mini-DIN connector, simply plug it in. 


If this is the first time you’ve used a mouse turn first to Section 1.4, How to 
Hold Your Mouse. If you are already familiar with a mouse product, turn to 
Book 2, LOGITECH Plus Software, for instructions on setting up your system 
to work with the LOGITECH Plus software that comes with your LOGITECH 
Mouse. 


Figure A-5 Alternate Cable Connectors 
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1.3 The LOGITECH Series 2 Mouse 


1.3.1 General Description 


Your LOGITECH Series 2 Mouse is designed for use with all models of IBM PS/2 
or compatible computers. It plugs directly into the mouse port and emulates the 
IBM PS/2 Mouse. You can use it with either a dual floppy system or with a hard disk. 


LG 


\- 


Figure A-6 LOGITECH Series 2 Mouse and 6-pin Connector 
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1.3.2 System Requirements and Compatibility 


1.3.2.1 System Requirements 
Here are the system requirements for the LOGITECH Series 2 Mouse: 


Personal IBM PS/2, Model 30, 50, 60, 80 

Computer or other 100% IBM PS/2 compatibles 

Drives Two disk drives, or a hard disk and at least one disk drive 
Memory 256 K of RAM 

Graphics IBM Monochrome Adapter 


Adapter Cards IBM Color Graphics Adapter 
IBM Enhanced Graphic Adapter 
with Enhanced Color Monitor or compatibles. 


Port PS/2 dedicated mouse port 
Operating 
System PC DOS or MS-DOS 2.0, or later 


1.3.2.2 LOGITECH Series 2 Mouse Compatibility 


The LOGITECH Series 2 Mouse driver works like the IBM PS/2 Mouse driver with all 
application programs that use the IBM PS/2 Mouse. MOUSE.COM and MOUSE.SYS 
from LOGITECH are functionally compatible with files of the same kind from JBM for 
the IBM PS/2 Mouse. 
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1.3.3 Install your LOGITECH Series 2 Mouse 


Your LOGITECH Series 2 Mouse comes with a 6-pin Mini-DIN connector that 
connects to the mouse port on your IBM PS/2 computer. To connect your mouse: 


Step 1: Switch your computer OFF. 
Step 2: Find the mouse port on your IBM PS/2 computer. 


Consult the system documentation for the location of the mouse port on the 
model you are using. 


Step 3: Plug in your LOGITECH Series 2 Mouse. 


Check the orientation of the plug and receptacle. The Mini-DIN connector will 
fit securely and easily. 


If this is the first time you’ve used a mouse turn first to Section 1.4, How to 
Hold Your Mouse. If you are already familiar with a mouse product, turn to 
Book 2, LOGITECH Plus Software, for instructions on setting up your system 
to work with the LOGITECH Plus software that comes with your LOGITECH 
Mouse. 
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1.4 How to Hold the Mouse 


Before you actually run your mouse software and start using your mouse, make sure you 
are well-situated for using your mouse. Place the mouse near your keyboard. The 
LOGITECH Mouse doesn’t need a special pad or grid - just a few inches of clear desk 


space. 


Figure A-7 Holding Your LOGITECH Mouse 


Position the mouse with the cable pointing away from you. The cord should move freely 
when you move the mouse. 


Now, feel how the mouse moves on your working surface. 


Hold the mouse in a relaxed manner, with your thumb and little finger at either 
side of the mouse. 


Place your index, middle, and ring fingers above the three mouse buttons. 
For a two-button mouse, use your index and middle fingers on the two buttons. 


Rest your wrist naturally on the desk surface. 
To move the mouse, let your hand pivot from the wrist. 
Be relaxed and use a light touch. 


Now go to the next division and install your LOGITECH Mouse software. 
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LOGITECH Mouse Maintenance 


Appendix A LOGITECH Mouse Maintenance 


The LOGITECH Mouse has been tested for 1,000 miles of continuous use with no 
deterioration in any of its functions. It will continue to run well beyond 1,000 miles and 
will perform optimally for longer than most people require over a period of years. 


Figure A-8 How Your Mouse is Assembled 


Recommended Cleaning Procedure 


The LOGITECH Mouse has a self-cleaning ball-cage mechanism that prevents a buildup 
of dust or lint around the ball or the tracking mechanism in normal conditions. 


If you need to clean the ball of dust or lint: 


Step 1: Switch your computer OFF. 


Step 2: Turn the mouse upside down. 
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Step 3: 


Step 4: 


Step 5: 


Step 6: 


Step 7: 
Step 8: 


Remove ball housing cover. 
Turn the ball housing cover counterclockwise to remove. 


Remove the ball. 


Clean the ball. 
Use tap water, or tap water and a mild detergent. Use a clean, lint-free cloth to 
dry the ball. 


Remove remaining dust or lint. 
Blow into the ball cage to remove remaining dust or lint. 


Put the ball back into the mouse. 


Replace cover. 
Fit ball housing cover over ball and turn clockwise until it locks. 
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Appendix B_ Product Support Plan 


Remember to send in your product registration card. It qualifies you as being 


eligible for customer support, and helps us keep you current with update and other 
important product information. 


Copy Protection 


LOGITECH software is not copy-protected. This doesn’t mean you can make unlimited 
copies. LOGITECH software is covered by the copyright laws that protect computer 
software. It is illegal to make copies of the contents of these disks, except for your own 
backup, without written permission from LOGITECH, Inc. In particular, it is illegal to 
give a copy to another person. 


Technical Support 


LBBS 


We know that effective communication with our customers is the key to quality service. 
Therefore we have set up the LBBS (LOGITECH Bulletin Board Service), an 
electronic bulletin board where you can contact us at your convenience, 24 hours a day, 
seven days a week. 

To logon to the LBBS, dial: 


(415) 795-0408 
using a 300, 1200 or 2400 baud modem. 


The menu of available options is self explanatory. 


BIX 


LOGITECH also sponsors an electronic conference on BIX, the Byte Information 
EXchange system from Byte magazine. If you have access to BIX, join us in the 
LOGITECH conference, and communicate with us there. 


Appendix B 


Getting Help through the Hotline 


You should be able to rely on your manual or your dealer to answer questions about 
using your package. If you do encounter a technical problem with your package, our 
Technical Support Specialists will be glad to help you. 


We ask you to follow these steps before you call or write. 


@ Read the section of the manual that describes the procedure you are trying to perform. 


e If the problem relates to your software, check to make sure that the software is | 
properly configured. 


e@ Please include the following information in your letter, or have it in front of you when 
you phone. 


* Mouse type and serial number 

* LOGITECH software type and serial number 

* LOGITECH Mouse driver version 

« DOS version . 

¢ Hardware and peripherals used 

* Contents of your AUTOEXEC.BAT file, if any 

¢ Contents of your CONFIG.SYS file, if any 

¢ Any RAM resident programs used (Sidekick, Superkey, etc.) 


If, after following these steps, you are still not able to solve the problem, give us a call at 
(415) 795-0427, or write to us. If you write, please include your daytime phone number 
and the best time to reach you. Also, please add "Attn: Technical Support" somewhere 
on the envelope. 


We want to help you make the most effective use of your package. 
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Introduction 


LOGITECH PLUS software provides the programmed intelligence to transform your 
LOGITECH Mouse from a simple pointing device into an easy-to-use desktop tool that 
can move your workload as fast as you can think. 


A simple installation program gets you ready. Next, mouse driver software gets you 
running. And then you are ready to run the two programs that are a major key to 
productivity — two programs that help your mouse to keep track of applications with 
speed and accuracy — LOGIMENU and CLICK. 


The INSTALL Program 


INSTALL is the first program your LOGITECH Mouse will use. It tests your mouse to 
determine whether it is working and what kind of mouse it is; it then establishes the 
“handshaking " ritual that lets it talk to your computer screen. For example, if you are 
using a LOGITECH Serial Mouse, it finds out whether to use COM1 or COM2 to 
communicate with your microcomputer system. 
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MOUSE.COM and MOUSE.SYS 


MOUSE.COM or MOUSE.SYS driver software contains the standard interface 
instructions between an application and your mouse. It tracks mouse position, gets data 
from the mouse buttons, and displays a text cursor or graphics pointer on screen, based 
on information from your mouse and your application. 


LMOUSE.DRV, a driver for Microsoft Windows, is also included. This driver may be 
more recent than the driver in the Windows package. For information on updating your 
Windows driver, refer to Section 6.9. 


The LOGIMENU Menu Generator 


MENU, the LOGIMENU program lets you write mouse procedures for non-mouse 
(keyboard cursor-key based) applications. LOGIMENU lets you tell the mouse buttons 
how to perform functions that would take several steps on the keyboard, it assigns menu 
options to difficult-to-remember keystrokes, and simplifies the way you move around in 
your application. 


LOGIMENU command language, lets you build a file with a .DEF extension that tells 
your mouse how to perform. Then you compile the .DEF program with the NEWMENU 
compiler. This produces a file with the same prefix, and an extension of .MNU. This 
.MNU file can then either be run as a single parameter to the MENU command, or it can 
be listed with the other .MNU files in the CLICK.SRC file to be ready to use whenever 
you run the CLICK program. 


Several working examples of these .DEF and .MNU files along with complete 
instructions on how to build your own menus are fully described in Chapter 3. 


CLICK functions as the control center for the LOGITECH Mouse with your application 
software. It sets operating parameters for the mouse and selects a menu designed for 
your application from among either the standard application .MNU files or those you 
construct with the LOGIMENU Menu Generator. 


You can use CLICK as it comes, already configured for many popular applications; or 
you can add your own applications and menus to the list in CLICK.SRC, to customize 
your LOGITECH Mouse for other application software. 


Getting Started 


Chapter 1 
Getting Started 


NOTE 
Before you install your software to either floppy drive or hard disk system, 
we strongly recommend that you take a few minutes to: 

1) Put Write-Protect tabs on all your LOGITECH diskettes. 


2) Use DISKCOPY and DISKCOMP from your DOS version to back up 
your diskettes. Then put your original diskettes in an archival area and use 
the copies for all installation. 


3) If you are using a dual disk floppy system, prepare formatted disks with 
readable labeling, before you copy the files in the Installation procedure 
which follows. 


Read the READ.ME file on your LOGITECH diskette, for last minute 
information that may not have been available when this manual was sent to 
the printer. 
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1.1 Back Up Your LOGITECH Mouse Disks 


If You are Using a Dual Floppy Computer: 


Step 1: Insert your DOS diskette in drive A. At the A> prompt, type: 
DISKCOPY A: B: 


Step 2: Follow the instructions on the screen. Insert your LOGITECH Mouse (source) 
diskette in drive A, and a blank (target) diskette in drive B. 


Press ; 


If You are Using One Floppy Disk and a Hard Disk: 
Step 1: At the DOS a> prompt or C> prompt, type, 
DISKCOPY A: A: 


Step 2: Follow the instructions on your screen. The source is your LOGITECH Mouse 
diskette, and the target is a blank diskette. 


‘Tf you are using 5 1/4" disks, note that: 


@ LOGITECH Mouse Driver Disk is labeled Disk 1. 
e@ LOGITECH Mouse Plus Disk is labeled Disk 2. 


If you are using 3 1/2" disks, note that: 


e@ Both Driver Disk and Plus Disk are on one disk labeled Plus Package. 
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1.2 INSTALL, the Mouse Installation Program 


These instructions tell how to install your software onto either a floppy drive or hard disk 
system. Instructions on screen tell you how to proceed. 


If You are Using a Dual Floppy Disk Computer: 


Step 1: Atthe A> prompt insert LOGITECH Mouse Disk #1 into drive A (if you are 
using 3 1/2 " disks there is only one disk to install), and type: 


INSTALL 


Step 2: Read the rest of the information on the screen and follow the instructions. 
If You are Using One Floppy Disk and a Hard Disk Drive: 


Step 1: At the c> prompt insert LOGITECH Mouse Disk #1 into drive A (if you are 
using 3 1/2 " disks there is only one disk to install), and type: 


A:INSTALL (1 } 


Step 2: Read the rest of the information on the screen and follow the instructions. 
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Chapter 2 
Mouse Drivers 


Two versions of the mouse driver are provided in the LOGITECH Mouse software. 
Both programs are functionally similar — you can use either one. 


MOUSE.COM is the standard driver. It can be used by itself on a command 
line, or made part of an AUTOEXEC.BAT file. 


MOUSE.SYS is the alternate driver. It conforms to the DOS standard for 
installable device drivers. To use MOUSE.SYS, one (but not both) of these 
lines must appear ina CONFIG.SYS file on your DOS disk: 


DEVICE=MOUSE.SYS for all LOGITECH Mice, except 
DEVICE=MOUSE.SYS /2 (for the Serial Mouse, on COM2) 


NOTE 


For information about modifying your CONFIG.SYS file, refer to your DOS 
manual. 
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2.1 Time-Saving AUTOEXEC.BAT Commands 


When your installation is complete, you may want to add some commands to your 
AUTOEXEC.BAT file in DOS to automatically load the mouse driver and the menu 
driver each time you start the computer. (Refer to your DOS manual for instructions on 
creating or modifying an AUTOEXEC.BAT file.) Make the following additions to your 
AUTOEXEC.BAT file. 


During software installation, you may be asked io create a file named GOMOUSE.BAT. 
To display the contents of GOMOUSE.BAT, type, 


TYPE \GOMOUSE.BAT 


GOMOUSE.BAT contains command lines that you can add to your AUTOEXEC.BAT 
file that will automatically load the mouse driver and the menu driver each time you start 


your computer. Refer to your DOS manual for instructions on creating and modifying an 
AUTOEXEC.BAT file. 


If you do not want to use the gomouse.bat file, you can add the following to your 
AUTOEXEC.BAT file: 


\DIRNAME\ MOUSE 
\DIRNAME\ MENU 
\DIRNAME\ CLICK 


where \DIRNAME is the directory where you have installed your mouse software. The 
default directory created by install program is \MOUSE. Remember also to add the 
directory name to your PATH statement as displayed in the GOMOUSE.BAT file. 


If you are running your mouse with a DEVICE=MOUSE.SYS statement in your 
CONFIG.SYS file, you can still use your AUTOEXEC.BAT file to run Logitech Plus 
software automatically when you start your computer. Remember to include the PATH 
statement that locates the corresponding files in your system. Then add these commands 
to your AUTOEXEC.BAT file. 


MENU 
CLICK 
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2.2 LOGITECH Serial Mouse — Special Parameters 


If your computer has limited memory, you can set parameters manually instead of listing 
them in the CLICK file. However, if you do not use CLICK, you will need to do this 
manually each time before you call an application. The parameters for this are described 
in Chapter 4. Here are the settings: 


COM Baud Report Buttons Protocol 
Port Rate Rate Used ae 
1* 10 2k 3b 


2 20 3k * 5b 
35 Ab 
50 He 


70 

100 

* 150 
or continuous 


* LOGITECH Serial Mouse default setting. 
** Protocol abbreviations: 


3b: Three byte packed binary 


5b: Five byte packed binary 
(default power-up without driver, 
Mouse Systems Corporation PC Mouse compatible) 


Ab: Absolute bit pad one 

He: Hexadecimal 

Mm: MMsSeries (default with driver) 
Re: Relative bit pad one 


The command and parameters for the mouse driver are: 


MOUSE [COM Port #] [Baud Rate] [Report Rate] [(# of buttons) k] [Protocol] (7) 
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The following steps explore this capability. 


Step 1: 


Step 2: 


Step 3: 


Step 4: 


Step 5: 


Step 6: 


Change to the drive and directory that has your mouse software and type: 
MOUSE ? 


On the screen, you’ll see the current mouse parameters. These are the default 
parameters identified by an * (asterisk) in the previous table. 


(INO Dr a ee ee ae 
If you change parameters, you can list them in any order: 


after MOUSE (if your mouse is using COM1), or 
after MOUSE 2 (if your mouse is using COM2). 


If you omit a parameter, it will not be changed. The mouse driver will 
maintain the last set value, usually the default setting. 


Your LOGITECH Serial Mouse can imitate a Mouse Systems Corporation 
PC Mouse: 


If your LOGITECH Serial Mouse is using the COMI serial port, type, 
MOUSE 1200 5B 150 

If it is using COM2, type, 
MOUSE 2 1200 5B 150( J } 


To check the new mouse parameters, type, 


To restore the mouse to its default parameters, type, 
MOUSE INIT(_.1 ) 


To be sure the default settings are working, type, 


MOUSE ?(_.1 ) 


By following Steps 1 through 3, you can manually set new parameters on your mouse to 
make it work with a particular application. 


Refer to Appendix B for a summary of mouse command language. 
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NOTE 


If the application you are using tells you to install the LOGITECH Serial Mouse as a 
Mouse Systems Corporation PC Mouse or compatible mouse, make sure you set the 
mouse driver to this mode. 


Option A: Copy MSC.BAT from Disk #1 to your mouse directory. 
Type MSC : 
Run the application that uses the Mouse Systems PC Mouse. 
Option B: Use the command, MOUSE PC 


Option C: Enter the mouse specifications for the application in your CLICK.SRC 
file and use NEWCLICK to generate a new CLICK.EXE file. See 
Section 4.3. 


If the applications does not list support of the LOGITECH Serial Mouse, but does list 
the Mouse Systems Corporation PC Mouse or compatible, you can still use one of the 
above-mentioned options. 
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Chapter 3 
Using LOGIMENU 


LOGIMENU lets you use your mouse with software not originally designed for mouse 
use. 


You can use LOGIMENU to create "pop up menus" that you can call onto your screen 
while you’re using your application. A LOGITECH Mouse pop up menu will give you 
options that you can select with the mouse. . 


You can also use LOGIMENU to define precisely how the mouse moves and how you 
want the mouse buttons to function. 


We have provided you with several working examples of LOGIMENU files that you can 
either copy and alter for your own purposes, or use as prototypes for menus that more 
closely meet your needs. 


Once you create a menu source file (using a a word processor or editor), with an 
extension name of .DEF, you compile that file with the NEWMENU Compiler. 


This creates a new file with a format that can also be recognized by the CLICK Mouse 
Control system; this file has an extension of .MNU. 
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3.1 Menus Supplied by LOGITECH 


A number of useful menus are already supplied on the LOGITECH Mouse diskette. 
These are listed with .DEF extensions. 


.DEF files are LOGIMENU programs or menus that must be compiled before they can 
be used. See the next section for instructions on how to create and compile LOGIMENU 
programs and menus. 


To compile the menu for VP-Planner from Paperback Software, type 
NEWMENU VP 


If you do not have this menu already loaded in your CLICK file, then to load the menu 
for VP-Planner, type: 


MENU VP 


You will see a message telling you that the Pop Up Menu is loaded. Now you can 
proceed to load VP-Planner by typing 


vp Cs) 


On Microsoft Menu Compatibility 


Microsoft Menu Source files can be compiled by NEWMENU. Do not use 
MENU directly with a .MNU file made by Microsoft’s MAKEMENU utility. 
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3.2 How to Build Your Own Menus 


LOGIMENU programs involve simple programming. LOGIMENU is designed to make 
this process simple and straightforward, for beginners and experienced programmers. 


A LOGIMENU program tells the mouse what to do. This chapter shows how to write 
these simple programs. To create LOGITECH Mouse programs and menus, you 
perform the following steps: 


Step 1: Use the POINT Editor or the nondocument mode of a word processing program 
like WordStar to write a LOGIMENU program <FILENAME>.DEF, where 
<FILENAME> is the same name as the .EXE or .COM file. 

Step 2: After you save your file and return to DOS, type: 

NEWMENU <FILENAME> (without the .DEF extension) 


NEWMENU compiles your menu so that you can use it. You do not need to 
specify the .DEF extension when you compile your menu. 


Step 4: If there are no errors, your menu is compiled and ready to use. 


If NEWMENU does finds error in your program, it will not compile. If this 
happens, refer to Appendix A for an explanation of the error message. Return 
to the .DEF file and make the corrections. Then start over at Step 2. 


On Microsoft Menu Source Files 


When compiling a .DEF file that was intended for a Microsoft two-button mouse, 


the mm) option is replaced by the . If you want it replaced by ; 
simply add the /1xm option to the NEWMENU command, like this: 


NEWMENU <FILENAME> /Irm 
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Once a LOGIMENU program or menu has been compiled, it can be called up by typing: 
MENU <FILENAME> 


See Chapter 4 for instructions on how to modify CLICK so that applications menus will 
be loaded automatically by the system. 


NOTE 
| For very large Menu Files: The menu driver has a default limit of 5000 bytes. | 


To produce a larger .MNU file, load MENU with a larger capacity. To do so, 
start MENU but add /<N> where <N> is a number of thousand bytes, up to 20. 


For Example: 


MENU /11 


reserves 11,000 bytes (11 Kb) for the menus to be used. 


This option is valid only when you first activate MENU. 
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3.3 ALOGIMENU Tutorial 


This tutorial shows you how to create six common LOGIMENU programs and menus. 
It explains the LOGIMENU language and how each program works. Key terms in 
LOGIMENU language are underlined the first time they are mentioned, and are defined 
in Section 3.4. 


Before beginning the tutorial, perform the following steps: 


If You are Using a Dual Floppy Disk Computer — 


Copy NEWMENU.EXE to a blank, formatted diskette. This will be your 
"practice diskette" for the tutorial. 


If You are Using One Floppy Disk and a Hard Disk — 


Create a new working directory. Your new directory will be where you will do 
your practice work throughout the tutorial. For more information on managing 
directories refer to your DOS manual. 


Get acquainted with the POINT Editor — 


At LOGITECH, we use the POINT Editor for all our program development. 
Even newcomers here are pleased and surprised at how easy it is to learn. You 
may find this an ideal time to also begin learning the POINT Editor. 


Differences Between Listings and Disk Files 


Your LOGITECH Mouse diskette contains the files for all programs and menus 
covered in this chapter. Some file listings may be different. 


and in Menu Listings 
The examples covered in this tutorial addresses both 3-button and 2-button mice. 
With a two-button mouse such as the IBM PS/2 compatible LOGITECH Series 2 
Mouse, MidB means both buttons; CHORD statements are disabled. for 
a 3-button mouse is equivalent to (ill M) for a 2-button mouse. 
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3.3.1 The EXTYPE Program 


EXTYPE programs the LOGITECH Mouse buttons to perform the DOS TIME, DATE, 
and VERsion functions. 


To create EXTYPE: 


Step 1: Open a file named EXTYPE.DEF. 
Step 2: On line 1, type: 
BEGIN LeftB, MidB, RightB | ma) , 
Step 3: Enter a blank line by pressing . 
Step 4: On line 3, type: 
LeftB: TYPE "TIME", ENTER, ENTER( .! }. 
Step 5: On line 4, type: 
; This calls the TIME command without changing the time( J } : 
Step 6: Enter a blank line by pressing : 
Step 7: On line 6, type: 
MidB: TYPE "DATE", ENTER, ENTER( 1 }. 
Step 8: On line 7, type: 
; This calls the DATE command without changing the date . 
Step 9: Enter a blank line by pressing : 
Step 10: On line 9, type: 
RightB: TYPE "VER", ENTER( .! }. 
Step 11: On line 10, type: 
; The VER command gives you the DOS version number : 
Step 12: Your screen should match the listing in Figure B-1. 


Step 13: Make needed corrections, and save the file on your practice diskette or in your 
working directory. Return to your DOS prompt. 
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Step 14: Compile EXTYPE. Type. 
NEWMENU EXTYPE 
Step 15: If NEWMENU finds an error in your program, it will not compile. If this 


happens, refer to Appendix A for an explanation of the error message. Then 
repeat Steps 12 through 14. 


If NEWMENU finds no errors, it compiles your program. The program is ready 
to use. Now click each mouse button in turn. 


Step 16: Press each mouse button and see what appears on the screen. 


BEGIN LeftB, MidB, RightB 


LeftB: TYPE "TIME", ENTER, ENTER 
7 This calls the TIME command without changing the time 


MidB: TYPE “DATE”, ENTER, ENTER 
7 This calls the DATE command without changing the date 


RightB: TYPE "VER", ENTER 
7 The VER DOS command gives you the DOS version number 


Figure B-1 The EXTYPE Program 
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How EXTYPE Works 
EXTYPE starts with a BEGIN statement: 
BEGIN LeftB, MidB, RightB 


The BEGIN statement assigns LABELS to mouse buttons: 


LeftB = 
MidB = |OQm@Q0 
RightB = 


These same labels are also listed near the left margin of your program. 


When you press a mouse button, your program looks for the label that matches it. Then 
it performs the action listed next to that label. 


This means that when you press , EXTYPE looks for the label LeftB and 
performs the action next to it. The action here is a TYPE statement: 


TYPE "TIME", ENTER, ENTER. 


This causes the program to type the word TIME and to "press" the key twice. This 
causes DOS to display the time. 


In a TYPE statement, you must put quotation marks around a word you want to be 
typed as a word. Because ENTER in the listing is not in quotation marks, EXTYPE 


interprets it as 


Three lines of your program start with a ; (semicolon). Those lines are comments. A 
COMMENT is a note you make to yourself that makes the program clearer when you or 
someone else goes back to see what you wanted to do and how you planned to do it. 
LOGIMENU ignores any information following a semicolon up to the end of the line. 
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3.3.2 The EXBEGIN Program 


EXBEGIN programs the mouse buttons to perform specific functions and determines 
how mouse movement affects the cursor. Here, you will make the mouse buttons 


simulate : , and {Esc}. Your program will make the cursor move when 
the mouse moves 50/200" horizontally or 100/200" vertically. To create EXBEGIN: 


Step 1: Open a file named EXBEGIN.DEF. 
Step 2: On line 1, enter: 

BEGIN LeftB, MidB, RightB, LeftM, RightM, UpM, DownM, 50, 100 
Step 3: Enter a blank line by pressing ; 


Step 4: On lines 3 through 5, enter: 
LeftB: TYPE ENTER 
MidB: TYPE 3 ; 3 is CTRL-C 
RightB: TYPE ESC 

Step 5: Enter a blank line by pressing : 

Step 6: On lines 7 through 10, enter: 


LeftM: TYPE 0, 75 ; 0, 75 is Left Arrow Key 
RightM: TYPE O, 77 ; 0, 77 is Right Arrow Key 
UpM: TYPE 0, 72 ; 0, 72 is Up Arrow Key 

DownM: TYPE 0, 80 ; 0, 80 is Down Arrow Key 


Step 7: Your screen should match Figure B-2. Make corrections, if necessary. 

Step 8: Save the file on your practice diskette or in your working directory. 

Step 9: To generate EXBEGIN.MNU from your EXBEGIN.DEF file, enter: 
NEWMENU EXBEGIN 

Step 10: If NEWMENU finds any error in your program, it will not compile, and will 


display an error message. If this happens, see Appendix A for an explanation of 
the error message. Then repeat Steps 7 through 9. 


If NEWMENU finds no error, your program is compiled and ready to use. Now 
move the mouse and click each mouse button in turn. 


Step 11: See how the mouse controls movement of the cursor on the screen. Observe the 
function performed by each mouse button. 
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BEGIN LeftB, MidB, RightB, LeftM, RightM, UpM, DownM, 50, 100 


LeftB: TYPE ENTER 

MidB: TYPE 3 7 3 is CTRL-C 

RightB: TYPE ESC 

LeftM: TYPE 0, 75 7 0, 75 is Left Arrow Key 
RightM: TYPE 0, 77 7 0, 77 is Right Arrow Key 
UpM: TYPE 0, 72 7; 0, 72 is Up Arrow Key 
DownM: TYPE 0, 80 7 0, 80 is Down Arrow Key 


Figure B-2. The EXBEGIN Program 


How EXBEGIN Works 


The EXBEGIN program starts with a BEGIN statement. 


BEGIN LeftB, MidB, RightB, LeftM, RightM, UpM, DownM, 50, 100 


BEGIN starts by labeling mouse buttons. 
LeftB 

MidB 

RightB 


BEGIN also labels mouse movements: 
LeftM (movement left), 


RightM (movement right), 


UpM (movement up), and 
DownM (movement down). 
Seven labels are listed at the left-hand side of your program. Each click of a mouse 


button or movement of the mouse tells the program to look for the label that corresponds 
to that mouse button or that movement. 


Note: Any label can be used to name a mouse button and its movement, as long as 
matching labels are listed down the left-hand side of the program. 
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In a BEGIN statement, LOGIMENU always recognizes these labels: 


Item one, 
Item two, 
Item three, 


Item four, movement left 
Item five, movement right 
Item six, movement up 
Item seven, movement down. 


This means that when you press , your program first looks for the label Lefts. 
Then it performs the action listed next to that label. The EXBEGIN program executes an 


C1). 


When you move the mouse to the right, a similar chain of events occurs. Your program 
looks for the label RightM. Then it performs the action listed next to that label: TYPE 
0, 77. The numbers 0, 77 are ASCII code for the cursor key. When the mouse 
moves to the right, your program executes and the cursor moves to the right. (More 
ASCII codes are listed in Section 3.4.2). 


The eighth and ninth items in the BEGIN statement refer to the sensitivity of the mouse, 
or how far the cursor will move when you move the mouse on the work surface. The 
eighth item indicates the mouse’s horizontal sensitivity. The ninth item indicates the 
mouse’s vertical sensitivity. 


In EXBEGIN, the number 50 indicates that when you move the mouse 50/200" 
horizontally, LOGIMENU registers a move to the left or right. 


The number 100 indicates that when you move the mouse 100/200" vertically, 
LOGIMENVU registers a movement up or down. 


In other words, if you move the mouse less than 50/200" horizontally or 100/200" 
vertically, no action is registered. 


If items eight and nine are not included in the BEGIN statement, the LOGITECH 
Mouse will use its default values: 4 and 8. 
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3.3.3 The EXEXECUT Program 


EXEXECUT programs the mouse buttons to display the directory for the current drive, 
drive A, and drive B. EXEXECUT shows you how to "chain" a sequence of commands, 
which is useful in programs with long statements. To create EXEXECUT: 
Step 1: Create EXEXECUT.DEF as it appears in Figure B-3. 
Step 2: Compile EXEXECUT. Type, 

NEWMENU EXEXECUT{( 1 } 


If NEWMENU finds errors in your program, it will not compile. If this 
happens, see Appendix A for an explanation of the error message. Then correct 
the file and repeat this step. 


Step 3: If NEWMENU finds no errors, then your program compiles and is ready to use. 
Click each mouse button in turn. 


BEGIN LeftB, MidB, RightB 


LeftB: EXECUTE TDIR, TRETURN 

MidB: EXECUTE TDIR, TSPACE, TA, TRETURN 
RightB: EXECUTE TDIR, TSPACE, TB, TRETURN 
TDIR: TYPE “DIR” 

TSPACE: TYPE " " 

TA: TYPE "A:" 

TB: TYPE “B:" 


TRETURN: TYPE ENTER 


Figure B-3 The EXEXECUT Program 


EXEXECUT starts with a BEGIN statement that labels the mouse buttons. A mouse 
button click sends program control to a label and does what that label says to do. 


An EXECUTE statement here sends program control to a combination of additional 
labels: TDIR, TSPACE, TA, TB, and TRETURN. Each of these labels triggers a 
TYPE statement. Combinations of labels create different final messages. 


In , for example EXEXECUT finds MidB and the EXECUTE statement next 
to it. EXECUTE then sends the program to a sequence of four labels: TDIR, TSPACE, 
TA and TRETURN. These in turn trigger TYPE statements that come together as: 


DIR A:(..! ). 
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3.3.4 The EXCHORDS Program 


EXCHORDS is a program for a three-button LOGITECH Mouse. It sets mouse button 


combinations to perform certain functions. These combinations ( , > 
, and (ll ll Ml) ) are called CHORDS. Here, each CHORD causes a line of type 
identifying the chord to appear on the screen, after which the CHORD will cancel its 


action by sending a 


NOTE 
| Chords do not apply to a two-button mouse, since (Ill ml) replaces | 


To create the EXCHORDS program: 


Step 1: Create EXCHORDS.DEF as it appears in Figure B-4. 
Step 2: To compile EXCHORDS.DEF, type, 
NEWMENU EXCHORDS 
When NEWMENU finds no errors in EXCHORDS.DEF, it is compiled and 
ready to use. 


Step 3: See how each button combination displays a different message on the screen. If 
your message is different than what you have pressed, check your listing. 


BEGIN 
CHORDS LMB, LRB, MRB, ALLB 


7 3 stands for CTRL-C, canceling the input 


LMB: TYPE "Left and Middle Buttons Pressed", 3 
LRB: TYPE "Left and Right Buttons Pressed", 3 
MRB: TYPE "Middle and Right Buttons Pressed", 3 
ALLB: TYPE "All Three Buttons Pressed", 3 


Figure B-4 The EXCHORDS Program 
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How EXCHORDS Works 


The EXCHORDS starts with an empty BEGIN statement and a CHORDS statement 
that labels the mouse button chords: 


LMB 
LRB 
MRB 


ALLB (mm) 


When you click one of these combinations, EXCHORDS looks in the program for the 
appropriate label and performs the action next to it. 


Suppose you press . The program finds the label LMB and performs the TYPE 
statement next to it: 


TYPE "Left and Middle Buttons Pressed", 3 
This types 
Left and Middle Buttons Pressed 
on the screen. 
Then it types the ASCII code 
3 
which causes the program to cancel by executing ‘ 
In this EXCHORDS, each chord executes a(Ctrl}{C) as its final action. You can easily 


Canti 2A% 
modify the program by substituting other ASCII codes from the table in Section 3.4.2. 
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3.3.5 The EXMENU Program 


EXMENU creates a menu on your screen and then programs mouse buttons and button 
chords to perform certain functions related to the menu. Here, a click of any mouse 
button or chord displays the menu. Then, by moving the mouse, you can highlight any 
of the menu options. Any single button click then selects the highlighted option, while a 
chord click cancels the menu. 


To create EXMENU: 


Step 1: Create EXMENU.DEF as it appears in Figure B-5. 
Step 2: Compile EXMENU. Type, 
NEWMENU EXMENU 


If there are no errors, EXMENU.DEF is compiled and ready to use. 


Step 3: Click any mouse button or mouse button chord to display the menu and click 
any chord to remove the menu from the screen. 


With the menu on the screen, move the mouse to highlight your selection. Click 
any mouse button to select a highlighted menu option. 


BEGIN menul, menul, menul 
CHORDS menul, menul, menul, menul 


menul: MENU "title", 8, 30, BOLD 
OPTION "DIR - LIST DIRECTORY", dir 
OPTION "PRINT file(s)", print 
OPTION “CHKDSK - check disk", chkdsk 
OPTION “RENAME file", rename 
MEND 


dir: TYPE "DIR", ENTER 
print: TYPE "PRINT" 

chkdsk: TYPE "CHKDSK", ENTER 
rename: TYPE "RENAME" 


Figure B-5 The EXMENU Program 
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How EXMENU Works 


EXMENU starts with a BEGIN statement: 
BEGIN menul, menul, menul 
This makes each mouse button call for label menu1. 
The CHORDS statement, 
CHORDS menul, menul, menul, menul 
also programs each chord, or mouse button combination, to call the label menul. 
The line next to the label menu1 defines the menu. 
menul: MENU "Title", 8, 30, BOLD 
Titles in quotation marks appear on the screen as the menu titles. 


The first number, 8, defines the line number at which the menu appears. 

The second number, 30, defines the column number at which the menu appears. 

The word BOLD says to display the characters on screen in bold. You can also choose 
NORMAL or INVERSE, or a number to indicate a color code (see your graphics 
adapter manual). 


The next four lines are OPTION statements. The words in quotation marks appear as 
menu options: 


DIR - LIST DIRECTORY, 
PRINT file(s), 
CHKDSK - Check Disk 
RENAME file 


The word at the end of each line is the label that the option will look for. MEND -- the 
MEND statement -- ends the menu definition. 


EXMENU works like this: When you click a mouse button to select an option, you also 
select a label. The program goes to that label and performs the action next to it. 


Suppose, for example, that you select CHKDSK - check disk. This selects the label 
chkdsk. The program finds this label and performs the action next to it, ie. it executes 


CHKDSK(_.! ). 
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3.3.6 The EXPOPUP Program 


EXPOPUP creates a pop-up menu on your screen. It is similar to EXMENU, but allows 
you much more flexibility in design of the menu. Menu items may be positioned 
anywhere on the screen, not just one below the other. 


EXPOPUFP also programs the mouse buttons and chords to perform certain functions. A 
click calls the menu. A click also selects a highlighted option. 


To create the EXPOPUP program: 


Step 1: Create EXPOPUP.DEF as it appears in Figure B-6. 
Step 2: Compile EXPOPUP.DEF. Type, 
NEWMENU EXPOPUP( .1 } 


When NEWMENU finds no errors in EXPOPUP.DEF, it is compiled, 
generated, and ready to use. 


Step 3: Click any mouse button or chord to display the pop up menu. Then click any 
chord to remove the menu from the screen. 


Step 4: With the pop up menu on screen, move the mouse to highlight an option. Click 
a mouse button to select the highlighted option. 


BEGIN popupl, popupl, popupl 
CHORDS popupl, popupl, popupl, popupl 


7 WARNING: The following line is a comment 
7 1234567890123 45678901234567890123456789012345678901 234567890 
popupl: POPUP 12, 20, NORMAL 

TEXT “" DIR - LIST DIRECTORY PRINT file(s} 

TEXT “ CHKDSK - check disk RENAME file 

SELECT 1, 3, 20, dir 

SELECT 1, 26, 13, print 

SELECT 2, 3, 19, chkdsk 

SELECT 2, 26, 11, rename 


PEND 
dir: TYPE “DIR", ENTER 
print: TYPE "PRINT" 


chkdsk: TYPE "CHKDSK", ENTER 
rename: TYPE "RENAME" 


Figure B-6 The EXPOPUP Program 
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How EXPOPUP Works 


EXPOPUP starts with a BEGIN statement and a CHORDS statement that causes any 
click to call the menu with the label popup 1. 


On line four, the line next to the label popup1 defines the menu you create: 
popup1: POPUP 12, 20, NORMAL 


The numbers 12 and 20 define where the pop-up menu appears — at line 12, column 20. 
NORMAL defines the properties of the menu characters as having normal type. 


Lines that begin with semicolons are comments which the program does not read. The 
numbers help you count characters and spaces so that you can enter other information. 


The next two lines of EXPOPUP are TEXT statements. The words in quotation marks 
appear as options in the menu exactly as they are arranged and spaced in the listing. 
The quotation marks indicate the outer edge of the menu. 


The four SELECT statements tell the program what to do when you select an option. 
Each SELECT statement consists of three (3) numbers and a label. 


The first number is the menu line on which the option appears. The option 
DIR — LIST DIRECTORY appears on line 1 of the menu, so the number is 1. 


The second number is the column number of the menu at which the option begins. This 
is where the numbers you used in the comment line help. 
The option DIR — LIST DIRECTORY begins at column 3, so the number is 3. 


The third number is the length of the option, counting both characters and spaces. 
For DIR — LIST DIRECTORY, that number is 20. 


PEND — the PEND statement — ends the pop-up menu definition. 


When you highlight an area of the menu and click a selection, the program matches the 
parameters of that selection with these numbers. 


DIR — LIST DIRECTORY, for example, sends control to SELECT 1, 3, 20, dir. 


The program then goes to the label dir listed at the left and performs the action next to 
it. In this case, it executes: 


DIR(). 
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3.4 LOGIMENU Reference 


This section provides a reference to LOGIMENU language and syntax. 


3.4.1 LOGIMENU Language 


Key terms in the LOGIMENU language are described in the following table. 


Term or 
Statement 


ASSIGN 
BACKSP 
BEGIN 
CHORDS 

3; <Comment> 
ENTER 

ESC 
EXECUTE 
<Label> 
MATCH 


MEND 
OPTION 
PEND 
SELECT 
TEXT 
TYPE 


Definition 


Assigns new behavior to mouse buttons and movements. 
TYPE function statement; simulates 

Defines function of mouse buttons at the start of a program. 
Defines a function of combinations of mouse buttons. 

Not read by the program. ; (semicolon) precedes the comment 
TYPE function statement; simulates 

TYPE function statement; simulates 

Chains together a sequence of commands. 

Name assigned to a statement or statements. 


Defines a string on the screen; sends the program to one label 
if the condition exists and to another if it does not. 


Ends a menu definition. 

Lists a menu option. 

Ends a pop up menu definition. 
Corresponds to a pop up menu selection. 
Lists text line of pop up menu. 


Sends characters and commands as if typed from a keyboard. 
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The following table lists extended ASCII codes that can be used with a TYPE statement. 


3.4.2 Extended ASCII Code 


Meaning 


Code 


Meaning 


Code 


Meaning 


Code 


® O 
¢ Typ} ]j} co COO © : 
PeeEeeeeeovsbeovovlwlae 


oO = cf Mom eoeANmrMaaAnNnEDOTDTODWA A 
oocoocoocoococooocooocoococoo eo 


7 
~ OF QOORPO SCO OR OE UORBEUGNKREOBOBE 
= |(-)(—)(}() (| (2) [=] (=) =] (=) (2) (| [| fe} fe] [lle [fel [al al al alle [= 
Fee e FREER REE EEEE 
OY SSARHANARRAAAAARHRTSLESSA 
SccodOCOcoooOoOdoO Oo coco oOcoC oO oO oO oO oO oOCO oO OoOSC So 


900800 sq9gS9 90008 0R888 R08 
SSSSE SEE EEEESSESESSSssge 
CHAMTtTNORAHROHANMYTHL 


a i Sa ik RS Rl SOP go SO ge 


AN 
oe) 


==) 
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Meaning 


Code 


Meaning 


Code 


TShift 


0,84 
0,85 
0,86 
0,87 
0,88 
0,89 
0,90 
0,91 
0,92 
0,93 
0,94 
0,95 
0,96 
0,97 


TShift 


Shift 


TShift H F4) 


Shift 


0,119 


Shift 


Shift 


Shift 


TShift 


Shift 


0,128 


0,98 


0,102 


0,133 


0,134 


NShift 


0,136 
0,137 


0,138 
0,139 


Alt 


0,109 
0,110 


Alt 


0,140 


B - 33 
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3.4.3 Color in LOGIMENU Programs 


A color monitor lets you have menus in color as well as menus in black and white. The 
MENU command in the LOGIMENU Definition file, lets you set the color with the last 
parameter. The syntax is: 


MENU <title>, <vertical position>, <horizontal position>, <color number> 


The fourth parameter may be a number ranging from 0 to 255. You can calculate the 


number, using the tables below: 


<color number> = 


Text Colors 
-Value Menu Text Color 
0 Black 
1 Blue 
2 Green 
3 Cyan 
4 Red 
5 Magenta 
6 Brown 
7 White 
8 Dark Gray 
9 Light Blue 
10 Light Green 
11 Light Cyan 
12 Light Red 
13 Light Magenta 
14 Yellow 
15 Intensified White 


(Text Colors) + (Background/Bar Colors) + (Blink On/Off) 


Selected Text Color 


White 
Orange 
Magenta 
Red 

Cyan 

Green 

Blue 

Black 
Intensified White 
Yellow 
Magenta 
Light Red 
Light Cyan 
Light Green 
Light Blue 
Dark Gray 
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Background/Bar Colors 


Value Background Color Selection Bar Color 


+0 Black White 
+16 Blue Orange 
+32 Green Magenta 
+48 Cyan Red 
+64 Red Cyan 
+80 Magenta Green 
+96 Brown Blue 
+112 White Black 
Blink On/Off 


Value Blinking Menu and Selected Text 


+0 Text is NOT Blinking 
+128 Text IS Blinking 


Example 


Refer to Section 3.3.5 and, if you have a color monitor, change the BOLD attribute in the 
menu syntax to: 


Text Colors = 10 Light Green on Magenta 
Background Base = 0 Black on White 
Blink on/off= 128 Blinking Text 


Color Number= 138 
And the new statement is 


MENU "title", 8,30,138 
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3.4.4 LOGIMENU Syntax 
The syntax of LOGIMENU statements is diagramed below, where: 


L_ isa label, the name associated with statement or statements 
N is anumber 


Statements That Define Mouse Buttons and Movements 


BEGIN Statement 
BEGIN has three (3) labels that indicate each mouse button, four (4) labels that indicate 
mouse movement, and two (2) numbers that indicate how much movement is needed to . 


trigger the specified action. 


BEGIN LeftB, MidB, RightB, LeftM, RightM, UpM, DownM, HSen, VSen 


(L) {L) (L) {L) {L) (L) (L) (N) (N) 
| | | | | | | | | 
| | | | | | | 
Labels for button Labels for mouse 


Number for horizontal sensitivity 


| | 
| | 
actions movements | | 
| | 
| | 
Number for vertical sensitivity | 


CHORDS Statement 


CHORDS has four (4) labels that tell what to do with each chord, or combination of two 
or more keys. Chords is only applicable on a three- button mouse. 
CHORDS LMB, LRB, MRB, ALLB 


(L) (LZ) (LL) (4k) 
| | | | 


| 1 | |_Babe1 for (im) 
oes iidbiel Fo 
2 ar 
| taper tee 
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ASSIGN Statement 


ASSIGN is the dynamic version of BEGIN. It lets you re-initialize for new situations. 


label: 

ASSIGN LeftB, MidB, RightB, LeftM, RightM, UpM, DownM, HSen, VSen 
(L) {L) (L) ({L) (L) (L) (1) (N) (N) 
| | | | | | | | | 
| | | | | | | 
Labels for button Labels for mouse 


| 
| 
actions movements | 
| 
| 


| 
| 
| 
| 
Number for horizontal sensitivity | 
Number for vertical sensitivity | 


How to Generate Input Characters 


TYPE Statement 


TYPE generates characters as if they were typed at the keyboard. 


label: TYPE <string> 
| 
|__This can be a sequence of any of the following, 
separated by commas: 

“string” 
character number 
0, extended ASCII code number 
ENTER 
BACKSP 
ESC 
TAB 


EXECUTE More Than One Statement 
EXECUTE defines a sequence of statements to be executed, so that more than one action 


can be executed for a mouse/menu action. 


label: EXECUTE label, label, 
| ! 


| |__ {L) Statements to be executed in sequence 


B - 37 
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MENU, OPTION, and MEND for a One-Column Menu 


MENU, OPTION, and MEND statements define and produce a menu that will stay on 
the screen until a mouse button is clicked (a mouse button chord will cancel the menu). 
When one mouse button is clicked to select a menu item, the associated label is executed 
and the menu disappears. There can be approximately 20 OPTION statements, which is 
close to the number of lines that can appear on the screen. 


label: MENU "Title", VPos, HPos, Attribute 
| | | 1 aioe INVERSE/BOLD/number 
re number of upper left corner 
eine number of upper left corner 


Menu title string, to appear on the top line 
(optional, but keep the comma ) 


OPTION “Item", label 
| | 
| | (L) Statement executed if menu item is chosen 
| 
| String to appear on the menu 


MEND 


| MEND statement to end menu definition 


Using LOGIMENU 


POPUP, TEXT, SELECT, and PEND for a Free-Format Pop-Up Menu 


As with the one-column menu, the pop-up menu will stay on until a mouse button is 
clicked to select an item, or until the menu is canceled by using a chord. With the 
POPUP, TEXT, SELECT, and PEND statements, you can build a menu with more 
than one column and with items that are not necessarily aligned. SELECT statements 
define the possible mouse selections. 


label: POPUP VPos, HPos, Attribute 
| | | 
| | |__ NORMAL/ INVERSE/BOLD/number 
| |__(N) Column number of upper left corner 
j__(N) Line number of upper left corner 


TEXT "string" 
| 
{__ String line to appear on the menu 
(you choose the layout) 


SELECT VPos, HPos, Width, label 
| | | | 
| | |__ Statement to be executed if 
| | | the item is chosen 
| | |__(N) Number of characters of the 
| | item 
| |__(N) Column number (inside the menu) of 
| the item 
|__(N) Line number (inside the menu) of the item 
PEND 
| 
|__ PEND statement to end pop-up menu definition 
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MATCH Checks for Something on the Screen 


Actions can be made context-sensitive by checking for the presence of certain signals 
from the application. For example, in most spreadsheet applications, a mode string or a 
prompt appears to indicate what is expected as input. The MATCH statement allows 


such checking, 


label: 


MATCH VPos, 


HPos, 


Attribute, 


"string", 


label, label 


| | 

| |____(L) Statement to be 

| , executed if there is 
| no match 
| 
| 


(L) Statement to be executed 
if there is a match 


String to be matched on the screen 


__NORMAL/INVERSE/BOLD/number/nothing 
attribute to match 
(optional, but leave comma) 

__(N) Screen column number where the match 
should start 

__(N) Screen line number where the match should start 
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3.5 Additional LOGIMENU Programs 


Once you master LOGIMENU, there are two additional programs you might want to 
create or modify: EXASSIGN and EXMATCH. 


The EXASSIGN Program 


The listing for EXASSIGN is in Figure B-7. The program assigns different modes to 
the mouse. With EXASSIGN, your LOGITECH Mouse can work as a normal mouse, a 
reverse mouse, a speedy mouse, or a slow mouse. 


BEGIN Menul 


Menul: MENU "EXASSIGN.MNU", 5, 20, NORMAL 

OPTION “Normal Mouse", Normal 

OPTION “Reverse Mouse", Reverse 

OPTION "Speedy", Fast 

OPTION "Slow", Slow 

MEND 
NormalMouse: ASSIGN Menul,MidB,RightB, LeftM, RightM,UpM,DownM, 4,8 
ReverseMouse: ASSIGN RightB,MidB,Menul1, RightM, LeftM, DownM, UpM, 4,8 


FastMouse: ASSIGN ,yeeree 1, 1 

SlowMouse: ASSIGN ,,,,,,, 500, 500 

MidB: TYPE ENTER 

RightB: TYPE ESC 

LeftM: TYPE 0, 75 ; 0, 75 is Left Arrow Key 
RightM: TYPE 0, 77 ; QO, 77 is Right Arrow Key 
UpM: TYPE 0, 72 ; 0, 72 is Up Arrow Key 
DownM: TYPE 0, 80 ; 0, 80 is Down Arrow Key 


Figure B-7 The EXASSIGN Program 


Chapter 3 


The EXMATCH Program 


The listing for EXMATCH is in Figure B-8. EXMATCH programs the mouse to act one 
way in a certain situation and a different way in another. Here, the program looks in a 
certain position on the screen to find the letters ABcDE. If it finds them, it displays the 
first of two screens. If it does not find the letters, it displays the second screen. On the 
second screen, one of the options is to call for the letters ABCDE to appear in the exact 
position on the screen where they were supposed to be. 


BEGIN CheckMatch 


CheckMatch: MATCH 3, 1, , “ABCDE", Matching, Notmatching 
Matching: POPUP 3, 30, NORMAL 
TEXT "** ABCDE now appears on this line “ee 
TEXT "* Select: ae 
TEXT "* xn 
TEXT "* CLEAR SCREEN CANCEL ae 
TEXT WHKKKKEKEKKEKKKKEKKKKEKKKKEKEKKKKKEKEKEKKEKEKKEKKEEU 


SELECT 4, 7, 14, ClearScreen 
SELECT 4, 30, 8 


PEND 

ClearScreen: TYPE “CLS", ENTER 

Notmatching: POPUP 3, 30, BOLD 
TEXT "“** ABCDE does not appear onthis line **" 
TEXT "* Select: baked 
TEXT "“* rar) 
TEXT "“* GET ABCDE TO APPEAR CANCEL = 
TEXT WHKEKKKKEKKKEKKEKEKEKKEK KKK KKEKKEEEKKEKKKEKEKHEKEKEEN 


SELECT 4, 6, 21, GetString 
SELECT 4, 32, 8 
PEND 


GetString: TYPE "CLS", ENTER, "ECHO ABCDE", ENTER 


Figure B-8 The EXMATCH Program 
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CLICK Mouse Control 


CLICK Mouse Control is a small program that stays "resident" in your computer’s 
memory. Then, when a program requires special mouse settings or menus, CLICK 
automatically makes sure things are correctly set up. 


With CLICK, your LOGITECH Mouse reaches its full potential as a multimode mouse. 
CLICK lets you move freely from task to task without resetting the mouse for each 
separate application. 


For mouse-based applications, CLICK configures mouse hardware so an applications that 
needs the mouse can read the signals the mouse sends. CLICK is configured for many 
popular applications. For the current list see Section 4.4. 


For non mouse-based applications, CLICK loads the available LOGIMENU 
specifications from a .MNU file. When the .MNU files are not present, you can create 
one with LOGIMENU for insertion into the CLICK.SRC file. 


Thus, you can easily customize CLICK to automatically install your LOGITECH Mouse 
with virtually any program you use. 
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4.1 How to Run CLICK 


To load CLICK into your computer, type: 
CLICK 


eae RIT TNE seer ere 
You may prefer to insert CLICK in the AUTOEXEC.BAT file of your DOS disk 


so that it is loaded automatically each time you start your computer. Refer to 
Chapter 2. 


CLICK.SRC is a list of application names and parameters that automatically sets the 
mouse to work with different applications and also loads the appropriate menus. 


In CLICK.SRC, applications are called by the names of their .EXE or .COM file. The 
command to set LOGITECH Mouse parameters then consists of the application’s .EXE 
or .COM name followed by a list of relevant parameters. 


TopView, for example, is referred to as TV for TV.EXE. The following line sets the 
mouse to function at 1200 baud, 150 reports/second, and 5 bytes (packed binary 
protocol): 


TV 1200 150 5b 


The command to load LOGIMENU consists of the application’s .EXE or .COM name 
followed by the word "MENU," thus: 


<Application Name> MENU 
For example, the command in CLICK.SRC to load the menu for VP-Planner is: 
VP MENU 


To see which application programs are supported by CLICK, look at the file 
CLICK.SRC with a word processor, with the POINT Editor, or with a DOS TYPE 
command. 
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If your application is listed in CLICK.SRC, then every time CLICK is loaded, it 
automatically sets the mouse and the appropriate menu. 


If your application is not currently listed in CLICK.SRC and the mouse requires special 
settings or the use of aLOGIMENU menu, see the Section 4.3. 


4.2 Click Speed/Sensitivity Control 


This feature lets you change the sensitivity of the mouse by holding down the and 
keys and then clicking either or(m Q Q)on the mouse to speed up or slow 


down the movement of the cursor on the screen. 


For a faster, more sensitive mouse, press 


(Ctrl}{ Ait HOO 


For a slower, less sensitive mouse, press 


(Ctri}{ Alt Hm OQ) 


To reset mouse sensitivity to its default value, press 


(Q mi Q) (not available with the LOGITECH Series 2 Mouse) 


In all cases, the computer will respond with a beep. The pitch of the beep will give you 
an idea of current sensitivity: the mouse becomes faster at the higher pitch and slower at 
the lower pitch. 


This sensitivity control feature is extremely useful for handling the mouse within certain 
applications. You can run an application at your own tempo, and increase 
sensitivity/speed at your own rate. Many applications even let you change the 
sensitivity/speed within the session. 
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4.3 Add Serial Mouse Parameters to CLICK 


CLICK can work automatically with your applications by adding a line for each 
application to the CLICK.SRC file. The line you add refers to your application by its 
.EXE or .COM file name, and then either lists appropriate parameters, or calls the menu. 


A CLICK.SRC entry is written in the style described in the previous section and 
specifies any of the information in the following table. 


Report Buttons Protocol 
Used ee 


If the word "MENU" 
comes after the 


application name, the 
corresponding menu 
will be loaded. 


continuous 


* LOGITECH Serial Mouse default setting. 
xk Protocol abbreviations. 
wa MENU is the only active parameter for a LOGITECH Series 2 Mouse. 
kkk* MENU and 2buttons or 3buttons are the only active parameters 
for a bus mouse configuration. 
Baud Rate The number of information bits exchanged per second between the 


(Serial Mouse) mouse and the computer. 


Report Rate Number of times per second that the mouse reports to the computer. 
(Serial Mouse) 


Buttons Used Buttons on the mouse. For some applications, it is convenient to 


(3 Button define a two-button mouse. In such cases, functions 
mouse only) as (if Mi) on a two-button mouse. 
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Protocol Refers to the data format and baud rate used by the serial mouse to 
(Serial Mouse) communicate with your computer. 


3b: Three byte packed binary 

5b: Five byte packed binary 
(default at power-up without driver, Mouse Systems Corp. PC Mouse 
compatible) 

Ab: Absolute bit pad one 

He: Hexadecimal 

Mm: MMsSeries (default with driver) 

Re: Relative bit pad one 


The user’s manual for your application may identify the parameters to set for your 
application to work with a mouse. If it doesn’t, the LOGITECH Mouse should work if 
you define it as either a Microsoft Mouse or a Mouse Systems Corporation PC Mouse. 


When you load the LOGITECH Mouse driver with any parameters, it will work like a 
Microsoft Mouse driver. 


If you want your LOGITECH Serial Mouse to emulate a Mouse Systems Corporation 
PC Mouse, set the following parameters in the CLICK.SRC file: 


<Application Name> 1200 150 5b 


If a parameter is not entered (such as the number of mouse buttons in the above 
example), then that parameter stays at its default value. Refer to the preceding 


chart for mouse parameter default values. 
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To add a new application and its parameters to CLICK: 


Step 1: 


Step 2: 


Step 3: 
Step 4: 


Open the CLICK.SRC file for editing. 

This can be done with the POINT Editor or with the nondocument mode of a 
word processing program like Microsoft WORD. 

Add a line in the CLICK.SRC file that includes the EXE or .COM file name of 
the application followed by a list of the parameters to use with that application. 
MENU is the only active parameter fora LOGITECH Series 2 Mouse. 


MENU and 2buttons or 3buttons are the only active parameters for a bus 
mouse configuration. 


In the following example, part of the line is a comment. Comments are 
notes you make to yourself that make an entry clearer when you read it 
later. All comments begin with a semicolon. When CLICK reads the 


CLICK.SRC file, it ignores any information following a semicolon. 


This line in CLICK sets LOGITECH Serial mouse parameters for TopView: 
TV 1200 150 5b ; TopView (IBM) 


CLICK will then change to these parameters automatically when you load 
TopView. In this example, the parameters are used to configure the serial 
mouse to emulate a Mouse Systems Corporation PC Mouse. 


Save your revised CLICK.SRC file. 
At the DOS prompt, type: 
NEWCLICK(_ } 


NEWCLICK uses CLICK.SRC to update CLICK.EXE and also revise the 
version of CLICK that is currently resident in memory. Each time you start 
your application, CLICK automatically loads the current mouse parameters. 
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4.4 CLICK Commands 


You can control CLICK with the following commands from your DOS prompt: 


NEWCLICK 
CLICK OFF 


CLICK ON 
CLICK PATH 


CLICK QUIET 
CLICK VERBOSE 


Reads revised CLICK.SRC file and updates CLICK. 


Switches CLICK OFF until you type CLICK ON. Use in 
troubleshooting to see whether a problem is 

in CLICK or in MENU. Does not take CLICK out of 
memory. 


Switches CLICK On. 


Shows the PATH used by CLICK to find the menu files. 
Notice that this is the PATH that was in effect when CLICK 
was loaded. 


Switches CLICK VERBOSE OFF. 


CLICK displays the full name of all programs when they are 
executed. 
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Notes: 


Popular Mouse Applications 
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Popular Mouse Applications 


This chapter tells you how to manage your applications with the CLICK Menu Control 
system. 


5.1 Applications with No Set-Up Procedures 


After you connect your LOGITECH Mouse and install the mouse software, experiment 
with the installation procedure for the application program that you will be using. In 
many cases, you can install and use the mouse with your application with no additional 
external setup. 


The procedures on this section are not necessary if you have modified your 
AUTOEXEC.BAT file to load MOUSE, MENU, and CLICK automatically. 
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With a Dual Floppy System: 


Step 1; At the A> prompt, remove the DOS disk. Insert the LOGITECH Mouse 
diskette in drive A. Type: 


MOUSE( .1 } 
If your LOGITECH Serial Mouse is using COM2, type: 


MOUSE 2 


Either command ioads the Mouse Driver into memory. 
‘Step 2: Now type: 
MENU 
This puts the LOGIMENU Menu Generator into memory. 
Step 3: Type: 
CLICK 
This loads CLICK Mouse Control into memory. 


Step 4: Remove the LOGITECH Mouse disk and insert your program disk in drive A. 
At the A> prompt, type the name of your application. 
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With a One Floppy Disk and a Hard Disk Drive: 


Step 1: 


Step 2: 


Step 3: 


Load the mouse driver. 


For a LOGITECH Serial Mouse connected to COMI, a Bus Mouse, or a 
LOGITECH Series 2 Mouse, at the DOS prompt, type: 


MOUSE( — ) 
If your LOGITECH Serial Mouse is using COM2, then type: 
MOUSE 2 
Load the LOGIMENU driver and CLICK. 
Type: 
MENU 
Type: 
CLICK 
Run your application program. 


If no further settings are necessary, the calls to CLICK and MOUSE put your 
mouse to work with your application. Move the mouse and experiment with it. 


If there is a LOGIMENU program for your application, calls to CLICK and MENU let 


you: 


Call the application menu with a mouse button. 


Choose menu options: 
Move the mouse to highlight a screen option. 
Click a mouse button to select the option. 


Cancel the menu with a chord click 
(two or more mouse buttons pressed at the same time). 


After you do the steps in this section, if the mouse works automatically with your 
application, then you are ready to go. If not, read the next section. 
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5.2 Programs That Use the LOGITECH Mouse 


CLICK Mouse Control is configured to handle mouse settings automatically for the 
following applications. 


AutoCAD - (registered trademark of Autodesk) 
Generic CADD - (trademark of Generic Software) 
Cadkey - (registered trademark of Micro Control Systems) 


Cadvance - (ademark of CalComp ) 


DesqView - (trademark of QuarterDeck Office Systems) 
DotPlot - (trademark of Generic Software) 

Drafix - (trademark of Foresight Resource) 

Dr Halo IT- (registered trademark of Media Cybernetics) 
EE-Designer - (trademark of Visionics) 

IBM Drawing Assistant - (trademark of IBM) 

IBM DisplayWrite 4 - (trademark of IBM) 

LaserCAD - (trademark of DSL, Inc.) 

Newsroom-Pro - (trademark of Springboard Software Inc.) 
PCad - (registered trademark of PCad) 

TopView - (trademark of IBM) 

Ventura Publisher - (trademark of Ventura Software, Inc) 
VersaCADD - (trademark of T&W) 


When the mouse driver is loaded, LOGITECH Mouse works with any of the following 
applications. 


AutoSketch - (trademark of Autodesk) 

ClickArt Personal Publisher (trademark of Software Publishing) 
Easy - (trademark of MicroPro) 

Flight Simulator - (registered trademark of Microsoft) 

GEM - (registered trademark of Digital Research) 

Harvard Professional Publisher - (trademark of Software Publishing) 
Norton Commander - (trademark of Peter Norton) 

OrCAD - (trademark of OrCAD Systems) 

PC Paintbrush Plus - (trademark of ZSoft) 

Personal Designer - (trademark of Computer Vision) 

pfs: First Publisher - (trademark of Software Publishing) 


Popular Mouse Applications 


Point Text Editor - (trademark of LOGITECH, Inc.) 
Publishers Paintbrush - (trademark of ZSoft) 
QuickBasic - (registered trademark of Microsoft) 
Reflex - (trademark of Borland) 

RoboCAD-PC (trademark of ROBO Systems) 
Smalltalk V - (trademark of Digitalk) 
ShowPartner - (trademark of Brightbill Roberts) 
smART WORK - (trademark of Wintek) 
Telepaint - (trademark of LCS Telegraphics) 
TurboCad - (trademark of Pink Software) 

Word - (registered trademark of Microsoft) 


LOGITECH Mouse works with the following applications because they use their own 
driver to run the mouse. 


IN*A*VISION - (trademark of Micrographics) 
PageMaker - (trademark of Aldus) 
Windows - (registered trademark of Microsoft) 


LOGITECH Mouse software provides a ready-to-use menu for the following 
applications. 


Edlin - (Microsoft) 

Framework - (trademark of Ashton-Tate) 

QMODEM .- (trademark of The Forbin Project) 
SuperCalc - (registered trademark of Sorcim Corporation) 
Symphony - (registered trademark of Lotus Development Corp.) 
Turbo Pascal - (trademark of Borland International) 
Turbo Prolog - (trademark of Borland International) 
VP-Planner - (trademark of Paperback Software) 
WordPerfect - (trademark of WordPerfect Corporation) 
WordStar - (trademark of MicroPro Corporation) 
XTREE - (registered trademark of Executive Systems) 


For the latest list of compatible software, use the POINT editor or your word processor to 
look at CLICK.SRC. 
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5.3 Definition Files for Other Applications 


Your LOGITECH Mouse diskette also contains definition files for many other menus. 
To see the complete list, insert your LOGITECH Mouse diskette in drive A and type: 


DIR *.DEF(.! } 
Files with the .DEF extension can be compiled with the NEWMENU compiler into 


.MNU files for use with CLICK. 


For more information on the creation and use of these menus, see Chapter 3. 


5.4 If Set-Up Procedures Are Needed 


If your LOGITECH Mouse does not work automatically with an application (or if it 
does, but clicking a mouse button fails to produce a menu), some additional set-up 
procedures may be necessary: 


e You may need to configure the computer and its input/output devices to use the 
mouse with your application. Use the installation program of the application 
software. (Refer to Section 5.5.) 


e You may need to set the LOGITECH Mouse parameters to work with your 
application. 


NOTE 


If your application is listed in Section 5.2, it either requires no special 
parameters, or CLICK is setting the parameters automatically. See the 
READ.ME files also for the latest information about applications that are 
handled automatically by your LOGITECH Mouse. 


Parameters define how your mouse communicates with the computer. 
To add your application’s parameters to CLICK so that the LOGITECH 


Mouse can be used automatically any time you call your application, 
refer to Chapter 4. 


e If LOGITECH Mouse software does not provide a menu for your application 
you can build a menu with LOGIMENU. (See Chapter 3.) 


Popular Mouse Applications 


5.5 Installing Applications 


Most applications support an input device as well as a keyboard. During selection of the 
input device to use with the application, you will see different mouse types. If your 
LOGITECH Mouse and mouse type is listed, then select it and proceed. 


5.5.1 LOGITECH Serial Mouse 
If you have a LOGITECH Serial Mouse, select: 


LOGITECH C7, R7 or Serial Mouse 


This installs your application for use with the LOGITECH Serial Mouse. 


Mouse Systems Corporation PC Mouse 


Select this and follow directions on screen. Then go through Section 3.1 again, 
to be sure that your LOGITECH Serial Mouse works correctly when installed 
as a Mouse Systems Corporation PC Mouse. 


NOTE 


In Section 3.1, for Step 1 substitute the following: 
At the DOS prompt, if your mouse is using COML1, type: 


MOUSE PC(.! ) 


If your mouse is using COM2, type: 


MOUSE 2 PC(_.. } 


If your mouse works with the application, Steps 3 and 4 in Section 3.1 
are not necessary. 


Microsoft Mouse 


Often refers to the Microsoft Bus Mouse (or MOUSE.COM). 
Follow directions on screen. Go through Section 3.1 again to confirm that your 
LOGITECH Serial Mouse will work as a Bus Mouse. (This option forces the 
application to use the resident mouse driver.) 


One of the above options should configure the application to work with your mouse. 


For some applications, configure input and output devices to use the LOGITECH 
Mouse. Chapter 6 has notes on several popular application installation procedures. 
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5.5.2 LOGITECH Bus Mouse 


If your application has a mouse installation menu, you may select either LOGITECH 
Bus Mouse or Microsoft Bus Mouse. Afterwards your LOGITECH Bus Mouse should 
work with your application. 


When you install an application that uses a Bus Mouse, you can choose to install it as a 
Microsoft Bus Mouse. 


ih -¢e-at pd oo oe 


'H Series Z Mouse 


If your application has a mouse installation menu, you can choose to install it as an 
IBM PS/2 Mouse. Afterwards your LOGITECH Series 2 Mouse should work with your 
application. 


When you install an application that uses a LOGITECH Series 2 Mouse, you can choose 
to install the program for the IBM PS/2 Mouse. 


General Installation Notes 
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General Installation Notes 


Before using your LOGITECH Mouse with application software, you must configure the 
computer and its input/output devices to use the mouse. Do this when you install the 
software. 


The following pages describe this procedure for several of the more popular applications. 


6.1 Automatic Installation 


The LOGITECH Mouse works with most software packages without special set-up 
procedures. 


In addition, CLICK Mouse Control software and LOGIMENU Menu Generator 
software make it easier than ever to tailor both mouse-based and non mouse-based 
applications to be used with your LOGITECH Mouse. 


Refer to Section 5.2 for a list of programs that run with the LOGITECH Mouse. 
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Step 1: 


Step 2: 
Step 3: 


Step 4: 


Step 5: 


Step 8: 


Step 9: 


6.2 AutoCAD 


From the AutoCAD Main Menu, select: Configure AutoCAD. 

e@ If you have a LOGITECH Serial Mouse, go to Step 2. 

e If you have a LOGITECH Bus or Series 2 Mouse, go to Step 4. 
Select: Allow I/O port configuration. 


At the prompt: 

Do you really wish to do I/O port configuration? <N> 

Type: (Y) for yes. 

Select: Configure digitizer. 

e If you have a LOGITECH Serial Mouse, select: Logitech Logimouse. 


Listings may alternately show Logitech R5, R7, C7, Or Logitech 
Serial Mouse, depending on your version of AutoCAD; Go to Step 5. 


e If you have a LOGITECH Bus or Series 2 Mouse, select Microsoft 
Mouse or whichever name reflects your mouse type; Go to Step 9. 


At the prompt: Enter port name, or address in hexadecimal 
if your mouse is using the COML serial port, type: 


3F8(_.! ) 


or, if your mouse is using COM2, type: 


2Fs(_.! ) 


At the prompt: — 
Do you want to adjust the Logimouse scaling factors? 


Type: Y for yes. 


: At the prompt: Fast motion factor, 0 to 255 <3>, 


choose a factor between 5 and 20. 


At the prompt: 
Fast motion threshold, 0 to 2047 <100>, 
choose a threshold of 1 or 2. 


Return to the AutoCAD Main Menu. At the prompt: 
Do you want to keep these changes? 
Type: Y for yes. 


If you run AutoCAD with a Serial mouse without CLICK, you must set the Baud Rate 
each time to 9600 by issuing the command MOUSE 9600 before starting AutoCAD. 
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6.3 CADVANCE 


CADVANCE has an internal driver for the LOGITECH Serial Mouse. The installation 
procedure is detailed in the CADVANCE manual. To install the mouse driver, type: 


INSTALL GI MSYS(_ ) 


6.4 FrameWork II 


FrameWork II requires no special LOGITECH Mouse installation procedure. 


To use the supplied FrameWork II menu with this application, however, you need to 
make sure that the communications facility for FrameWork I does not address the same 
serial port used by the LOGITECH Serial Mouse. 


6.5 GEM 


Step 1: Start the GEMPREP install program. 


Step 2: At the GEM prompt: 
What kind of mouse do you have?, 
select Microsoft Bus Mouse. 


Step 3: At the GEM prompt: 
Do you have a Microsoft Bus Mouse? Y/N, 
respond: Yes. 


Step 4: At the prompt: 
Insert the Microsoft Mouse distribution disk in drive A 
insert the LOGITECH Mouse diskette in drive A. 


Step 5: Follow the rest of the instructions on the screen. 


The above selection will force the application to use the mouse driver in resident 
memory. If you are using a LOGITECH Serial Mouse and selected the Mouse Systems 
PC Mouse,refer to Section 2.2 for instructions. 
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6.6 Generic CADD 


Generic CADD expects the LOGITECH Serial Mouse to run in the Mouse Systems (PC 
Mouse) emulation mode. CLICK will configure your LOGITECH Serial Mouse to run 
in this mode. If you are not using CLICK, refer to Section 2.2 for proper settings. 


If you have a LOGITECH Bus Mouse, please follow instructions in the CADD 
installation menu. 


6.7 PC PaintBrush 


To use this application with the LOGITECH Serial Mouse, replace the PC PaintBrush 
file LOGIMOUS.COM with the LOGITECH file MOUSE.COM. 


Then, in the Install session, choose LOGITECH Mouse as the drawing device. 
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6.8 Symphony 


The SYMPHONY.MNU LOGIMENJU file is on one of your LOGITECH Mouse disks. 
Also SYMPHONY.DEF can be modified and compiled by NEWMENU. 


With this setting, is used as and as . The use of 
depends on the detected mode of Symphony. See below. 


NOTE 


If you are using a LOGITECH Serial Mouse, install the mouse on COM2 since 
Symphony reserves COMI for communications. Specify this in Symphony’s 


INSTALL the first-time installation procedure of Symphony’s INSTALL program. 


How your mouse works with SYMPHONY 


is is is 
always Menu if Sheet always 
or 
ANCHOR if Point Esc 
or 
Mouse Help 


6.9 Ventura Publisher 


Step 1: Start the Software installation. 


Step 2: If you have either a LOGITECH Serial Mouse or a LOGITECH Bus Mouse At 
the mouse selection prompt, select Microsoft Bus Mouse or MOUSE.COM. 
This will orient Ventura Publisher to use the mouse driver resident in memory. 
For the LOGITECH Series 2 Mouse, select the IBM PS/2 Mouse. 


Some versions of Ventura Publisher recommend installation of the LOGITECH Serial 
Mouse as a Mouse Systems Corporation PC Mouse. If you find this more convenient, 
please refer to Section 2.3 for proper settings. 
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6.10 Windows 


If you have an older version of the LOGITECH Serial Mouse Windows driver, upgrade 
to the latest version: 
Step 1: Back up the Windows Setup disk (disk No. 1). 


Step 2: Copy LMOUSE.DRV from the LOGITECH Mouse diskette to the Windows 
Setup diskette. 


Step 3: Reinstall Windows. (This process will not damage your existing 
Windows data files and is faster than the first Windows installation.) 


NOTE 


When you select the above option, you are orienting Windows to use the 
LOGITECH enhanced mouse driver LMOUSE.DRV, no matter which type of 


mouse you are using. 


If you are installing Windows and the LOGITECH Serial Mouse for the first time: 


Step 1: Start the Windows Setup program. 

Step 2: At the prompt, 
Which pointing device do you have? 
select LOGITECH Serial Mouse. 


WN. Ut 


Step 3: Foiiow the resi of the instructions on screen. 


6.11 Microsoft Word 
Word requires no special LOGITECH Mouse installation procedure. CLICK 
automatically configures the mouse each time you start Word. Note that your mouse 
then functions as a two-button mouse, with the acting as a simultaneous click of 


CET 


Make sure you use the LOGITECH mouse driver and not the Microsoft Driver that is 
sometimes copied to the CONFIG.SYS during Word installation. 
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Appendix A 
Mouse Status Messages 


These status messages will help you to determine various functional errors as you use 
your mouse. 


Cannot open file CLICK.SRC 


NEWCLICK has searched for the revised CLICK.SRC file in the current 
directory and through all the directories in the PATH and cannot find it. (For 
more information about PATH, refer to your DOS user’s manual.) If you don’t 
have the file CLICK.SRC in one of those directories, NEWCLICK won’t find it 
and will display the above message. See Chapter 4 and the instructions for 
customizing CLICK. 


Cannot open file <filename>.DEF 


NEWMENU has searched for .DEF through all the directories in the PATH and 
cannot find it. (For more information about PATH, refer to your DOS user’s 
manual.) If you don’t have the file .DEF in one of those directories, 
NEWMENU won’t find it and will display the above message. See Chapter 3. 


Cannot write file <filename>.MNU 

There is not enough space left on your disk or the disk is write-protected. 
CLICK already active 

You have tried to reload CLICK when it is already loaded and is not disabled. 
CLICK is not loaded - (just type CLICK to load it) 

You have typed a command such as CLICK OFF when CLICK wasn’t loaded. 
CLICK requires Logimouse Driver 3.xx - you have something else loaded 


The current MOUSE.COM or MOUSE.SYS is either out of date, or for a 
different mouse. Check your directories or program disks for duplicate 
MOUSE.COM or MOUSE.SYS files. Then reboot, and load the correct 
mouse driver. 
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CLICK: Unrecognized Parameter 


You have typed CLICK with a parameter other than OFF, ON, VERBOSE, 
QUIET, or PATH. 


First statement must be BEGIN 


Your .DEF file does not open with a BEGIN statement, which LOGIMENU 
requires. Create a BEGIN statement for this file. Refer to Chapter 3. 


Invalid number of arguments 
A statement in your .DEF file has a predefined number of arguments. The 


number of arguments you supply does not match this predefined number. 
Correct your file. Refer to Chapter 3. 


Invalid statement : Line XX 


Check the displayed statement from your .DEF file. The statement somehow is 
wrong. Refer to Chapter 3. 


Invalid statement arguments 


You have made an argument that is not valid for a statement in your .DEF file. 
Check the file to locate the error and then correct it. Refer to Chapter 3. 


Label is already defined 


You have duplicated a label in your .DEF file. Find the mistake and correct it. 
Refer to Chapter 3. . 


Label is not followed by a statement 


You have left an empty label in your .DEF fiie. Create a statement for this label 
in the file. Refer to Chapter 3. 


Label not defined 


You have omitted a definition from a label in your .DEF file. Find the mistake 
and correct it. Refer to Chapter 3. 


Label table overflow 


NEWMENU cannot handle more than 320 labels in one menu file. 
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Line XX: Error: Too many applications to configure 


CLICK cannot handle so many applications. Remove the lines that you do not 
use from CLICK.SRC. Then, at the DOS prompt, type NEWCLICK 


Line XX: Warning: application name truncated to <filename> 


You have entered an application name that is too long for the CLICK.SRC file. 
NEWCLICK has truncated (or shortened) this name to its first eight characters. 


Line XX: Warning: invalid keyword: <invalid mouse parameter> 


You have entered an invalid mouse parameter in the CLICK.SRC file. See 
Chapter 4 and the table that lists all the acceptable mouse parameters. 


Menu code too big 


The size of an .MNU file cannot exceed 20K bytes. See Chapter 3 about how 
to expand MENU’s loaded size. 


Mouse driver not found 


You have called MENU when the mouse driver was not loaded. MENU cannot 
work without the mouse driver. Type MOUSE (_.1 ) to load the driver. 


MSDOS version 2 or above required 
Check your software. MENU works with only DOS versions 2.0 and above. 


Option Ignored 


You have tried to use "/" option after you activated the MENU driver. See 
Section 3.1. 


OPTION or MEND Expected 
You have omitted or mislabeled an OPTION statement or MEND statement in 


the menu subroutine of your .DEF file. Find the mistake and correct it. Refer 
to Chapter 3. . 
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PopUp Menu File not found 


MENU searches for a menu file in the current directory and all directories in 
your PATH. (For more information about PATH, refer to your DOS manual.) 
If you don’t have the .MNU file in one of those directories, MENU won’t find it 
and will display the above message. You have probably not completed the 
compilation of the menu. Refer to Chapter 3 for instructions about the 
NEWMENU command. 


Read Error on Popup Menu File 


An error occurred when reading the .MNU file. Try the command again. Check 
the file and your disk if the error message is repeated. 


SELECT, TEXT or PEND Expected 


You have omitted or mislabeled a SELECT statement, TEXT statement, or 
PEND statement in the POPUP subroutine of your .DEF file. Find and correct 
the mistake. See Chapter 3. 


This statement requires a label 


You need to have a label before a particular statement in your .DEF file. Create 
a label for this statement in your file. Refer to Chapter 3. 


Unable to create file <filename>.MNU 


There is not enough space on the disk to compile the requested menu file, or else 
the disk you are trying to use is write-protected. 


Usage: NEWMENU file[.def] [/lrm] 
You have entered the NEWMENU command without a .DEF file to be compiled. 
Example: NEWMENU FW produces FW.MNU for LOGIMENU to use. 
Warning: Menu Driver has not been loaded (type MENU)! 
CLICK is telling you that LOGIMENU is not loaded. Type MENU(_-! }. 


Warning: Mouse Driver has not been loaded (type MOUSE)! 


You have called CLICK when the mouse driver was not loaded. CLICK cannot 
work without the mouse driver. To load the driver, type MOUSE 


Mouse Command Language 
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Mouse Command Language 


The following commands and parameters are for the LOGITECH Mouse system: 


Mouse Driver Commands 
(for Serial Mouse) 


MOUSE <com PorT #> <BAUD RATE> <REPORT RATE> [<# OF BUTTONS> K] <PROTOCOL> (7?) 


MOUSE 
MOUSE 2 
MOUSE INIT 
MOUSE PC 
MOUSE ? 


MENU 


MENU /N 


MENU <FILENAME> 
MENU OFF 


Command and parameters for the mouse driver. Parameters 
can be used singly or in combination. 


Load and configure mouse for COM1. 

Load and configure mouse for COM2. 

Reset mouse to initial parameters. 

Emulate a Mouse Systems Corporation PC Mouse. 


Display current mouse driver settings. 


LOGIMENU Commands 
Load the LOGIMENU Generator in preparation for 
implementing various mouse application menus. 


N equals one thousand bytes. Use to produce MNU files 
larger than the 5,000 byte default up to a limit of 20,000 bytes. 
See Section 3.2. 


Load <FILENAME>.MNU as application menu. 


Disable most recently loaded application menu. 


NEWMENU <FILENAME> 


Compile a <FILENAME>.DEF file into a <FILENAME>.MNU 
file, and load as a menu. 
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CLICK 
CLICK OFF 
CLICK ON 
CLICK PATH 


CLICK QUIET 


CLICK VERBOSE 
NEWCLICK 


CLICK Commands 


Load most recently compiled version of CLICK.SRC. 
Turn off CLICK. 
Enable most recently compiled version of CLICK.SRC. 


Shows the PATH used by click to find the menu files. 

This is the path that was in effect when CLICK was loaded. 
Turn off CLICK comments. 

Turn on CLICK comments. 


Compile and load most recent version of CLICK.SRC. 
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The Point & Click Shell 


Introduction 


M123, the Point & Click Shell is the LOGITECH Mouse interface for the Lotus 1-2-3 
spreadsheet program. It makes Lotus 1-2-3 work like a mouse-based program. With 
M123, you can execute multiple keystroke functions with a single click of a mouse 
button, as well as move your cursor quickly and easily from cell to cell. 


Here are just a few of the advantages that the Point & Click Shell gives you: 


Context Sensitive Pop-Up Menus 
The Point & Click Shell "knows" which mode you’re in and 
gives you a pop-up menu that makes sense when you need it. 


Programmable Pop-Up Menus 
You can easily adapt the pop-up menus to simplify and speed 
up repetitive tasks. (See Section 6) 


Num Lock Accelerator Speeds up data entry by turning the and (—) on the 
numeric keypad into and (-). 
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Section 1: Install The Point & Click Shell 


The Point & Click Shell consists of two M123 files: M123.COM and M123.MEN. 
To make the Point & Click Shell available whenever you use Lotus 1-2-3, add them to 
your Lotus 1-2-3 System disk. 


NOTE) 


This section is not necessary or applicable if you have already installed the Mi23 
files with the mouse INSTALL program. 


If You Have a Dual Floppy Drives: 


Step 1: Insert your Lotus 1-2-3 System disk in drive A. 
Insert your LOGITECH Plus software diskette in drive B. 
Step 2: At the DOS A) prompt, type: 
COPY B:\M123.* A: 


This copies Point & Click files to your Lotus System disk. 


If You Have a Hard Disk: 


Step I: Insert the LOGITECH Plus diskette in drive A. 
Step 2: Switch to your Lotus 1-2-3 directory. 
Step 2: Atthe DOS prompt, type: 

COPY A:\M123.%* 


This copies Point & Click files to your Lotus 1-2-3 directory. 
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Section 2: Start The Point & Click Shell 


To run the Point & Click Shell: 
Step 1: Load your mouse driver. 


If necessary, change to your mouse software directory and type: 


MOUSE 
Step 2: Call up the Lotus ACCESS menu. 
Change to your Lotus 1-2-3 directory and type: 
M123 
This loads the Point & Click Shell which in turn loads Lotus 1-2-3. 
Step 3: Select 1-2-3. 
In the Lotus ACCESS menu, use to select 1-2-3. 


NOTE 
To load 1-2-3 without going through the Lotus ACCESS menu: 


If you have Lotus 1-2-3 Version 1 A (123.EXE), type 
M123/1 


If you have Lotus 1-2-3 Version 2.0 (123.COM), type 
M123/2 


To pass a loading parameter (such as a different driver set) to Lotus 1-2-3, simply 
add it to the command line, or to a batch file. For example, to call 2-2-3 with a 
driver set named MY_SET.SET, type, 


M123/2 MY_SET 


In the sections that follow, experiment. Move the mouse and click the buttons to 
discover how the Point-and-Click Shell works. 
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Section 3: A Point & Click Tutorial 


Here is a Point & Click procedure that inserts some basic information into a typical 
spreadsheet, and then shows you how to save your work. 


Use (ml @ jinstead of hereafter, if you are using a two-button mouse. 


Step 1: 


Step 2: 


Step 3: 


Step 4: 


Step 5: 


Step 6: 


Step 7: 


Load M123 and Lotus 1-2-3. 


mW Aker pei pt bikes he ieee cee poe @ Pee hoes 
Follow the instructions outlined in Section 2. 


Load the days of the week into your spreadsheet. 
Point the mouse cursor to cell A2 and click : 


Press and hold to pop up the M123 menu. 


Slide the cursor highlight to Days, and release 
The days of the week are now listed horizontally in Row 2. 


Insert a new column. 


While the cursor is still at position A2, press again. 
Scroll down the pop up menu to Insert Column and release 
You have now inserted a new column before column A. 


Load the months of the year into your spreadsheet. 


Move the mouse cursor down to row 3 and click the : 


Press and hold to pop up the M123 menu. 
Slide the cursor highlight to Months, and release 
The months of the year are now listed horizontally in Row 3. 


Copy the month names to a column. 

Press|Q MQ), slide the cursor highlight to Transpose HV, and release. 
The months of the year are now also listed vertically in Column A. 
Erase the extra months. 


Point the mouse cursor to cell B3 and click 

Press , Slide the cursor to Erase Right, and release ’ 

The months of the year are erased, starting from the right of the cursor position. 
Save your worksheet. 


Press , move the mouse to Save in the right menu border, and release. 
At save file name, name your worksheet (e.g., HOLIDAYS). 


Press to confirm. 
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Section 4 Mouse Buttons 


4.1 Pointing and Editing 


Go to cell 


In READY, POINT, LABEL, and EDIT modes, point to a cell in the spreadsheet and click 
to make the cell current (ending the EDIT or LABEL mode if necessary). 


Edit cell 


In READY mode, point to the current cell and click for 1-2-3 to enter EDIT mode. 
Click again to go back to READY mode. 


End Point Mode 
In POINT mode, point to the current cell and click for 1-2-3 to receive a 
equivalent to a confirmation. 


Copy cell: [TShift}H m QQ) 


In READY mode, [ f'Shift H ml Q Q) copies current cell contents to the target cell. Warning: 
this replaces the contents of the target cell. 


Move cell: Cileie) 


In READY mode, {mi QQ) moves the current cell contents to the target cell. 
Warning: this replaces target cell contents, and deletes current cell contents. 


Edit mode, Label mode 


While in EDIT or LABEL mode, you can move the mouse cursor over the editing line. 
Clicking the to establishes the cursor at the selected position. Warning: this 
works only for editing the current cell. 
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4.2 Scroll bars 


NOTE 
| The actions on this page work in any mode. | 


Horizontal scroll bar 


For scrolling the spreadsheet left or right, the scroll bar is on the upper line with the 
column letters. Put the mouse cursor on the upper line, and press to scroll the 
column under the mouse position to the left side. Press to get the column on the 
left back to the mouse position. 


Vertical scroll bar 


For scrolling the spreadsheet up or down, the scroll bar is on the left with row numbers. 
Put the mouse cursor on a row number and press to scroll the line at the mouse 
position to the top. Press to bring the row on top back to the mouse position. 


Cursor bars 


The bottom line and the right side of the screen are cursor bars. With the mouse cursor 


in the area, is equivalent to , and is equivalent to 
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4.3 In and out of the Main Menu 


Click to call (forward slash) 


To call the 7-2-3 menu from READY mode, move the mouse cursor to the menu area at 
the top of the screen and press . This is the same as pressing , 


Menu item & click 


To select an item in the 1-2-3 menu (in MENU mode), move the mouse cursor over the 
menu item, and press the . This is the same as entering the first letter of the 
menu item. 


File name & click 


To select a file name in the 1-2-3 file menu (in FILE mode), move the mouse cursor over 
the file name, and press . This is the same as entering that file name. 
Moving the current menu item 


The bottom line of the screen is the cursor bar. 


To move one cursor position to the left, press the cursor on the bottom line. 
(OO mi) 


To move one cursor position to the right, press . The scroll bars operate in 
MENU and FILE modes, as if they were affecting the spreadsheet. 


Escape to Ready 


is equal to as the default setting in any mode. This cancels actions and 
goes back to READY mode from the 7-2-3 menu. You can alter the M123.MEN file to 


change how behaves. 
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4.4 Pop-up menus 


Middle button technique 


To reach the M123 pop-up menu, press and hold (Use (im) for a two-button 
mouse). Move the mouse down, left, or right, towards the desired item. 
Move the highlighting, stop on the desired item, and release the . The action 
called by the menu item is then taken. 


Main menu 


The main menu has options for quick action on the spreadsheet. Move the mouse to the 
left to select Retrieve. Move it to the right for the Save menu. Other options are 
convenient for quick operations, such as sum column, fast quit (do not forget to save!), 
etc. 


Home 

End Home 

Sum Column 
i Sum Line 


Print Ranga 


Worksheet Fmt 
Column Width 
Insert Row 
Insert Column 
Days 

Months 
Transpose HV 
Transpose VH 
Erase Right 
Erase Down 
Center Label 
Today 

Fast Quit 


Save 

Retrieve 

Home 

End_Home 
Sum_Column 
Sum_Line 
Print _Range 
Worksheet_Fmt 
Column Width 
Insert_Row 
Insert_Column 
Days 

Months 
Transpose_HV 
Transpose_VH 
Erase_Right 
Erase_Down 
Center _Label 
Today 


Fast_ Quit 


The Point & Click Shell 


Comments -- Main Menu 


Save file menu 

Retrieve file menu 

Go to upper left corner 

Go to lower right corner 

@svm formula for the above column 

@swuM formula for the line to the left 

Print Range menu 

Worksheet Format menu 

Change column width 

Insert one new row 

Insert one new column 

Enter a row of 7 cells with the days of the week 
Enter a row of 12 cells with the month names 
Transpose the row to a column 

Transpose the column to a row 

Erase the cells to the right of this line 

Erase the cells below in this column 

Prompt for a range of labels to center 


Enter today’s date as per the system (make sure your cell 
is more than 10 characters wide). 


Quit 123 without confirmation (make sure you save before!) 
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Secondary menu 


The secondary menu is used for all modes but READY. In these modes, RETURN, ANCHOR, 
HOME, and other options are used to terminate operations and travel through the 
spreadsheet (like in POINT mode). 


| 


5H G& ct Oo DW 


Home 


End Left 
End Right 
End Up 
End Down 
End Home 


KROPF aA 


Comments -- Secondary Menu 


Return 
Anchor Gos) 


Home Go to upper-left corner 
End Left Go to leftmost cell 
End Right Go to rightmost cell 
End_Up Go to top cell 
End_Down Go to bottom cell 
End_Home Go to bottom-right comer 
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Section 5 Point & Click Data Entry Accelerator 


To speed up data entry, the Point & Click Shell has changed the function of (+) and (—) 
on the numeric keypad. 


has the same effect as(J). 
(—) has the same effect as (>). 


This means that if you need to enter numerous rows and columns of figures, then, 


If you are entering a column of figures: 
(1) Type the entry for a cell. 
(2) Press ; 
(3) Type the next entry. 


If you are entering a row of figures 
(1) Type the entry for a cell. 
(2) Press (=). 
(3) Type the next entry. 


M123 


Section 6 Your Own Point & Click Menu (For Advanced Users) 


The listings on the Point & Click Shell menus may not be the ones you would choose. 
You can modify the function of the Point & Click Shell menus, of the mouse 
button, or the (=) and keys by using a text editor like the POINT Editor or the 
nondocument mode of a word processing program like WordStar. When modifying 
M123 files, you must follow the format that is set in the M123.MEN file, below. 


i aa cae ace RA RATOR ae 


Each program in Mi23.MEN consisis of items in parentheses. Each item in a sequence 
is separated by the | character. Spaces are not read by M123. For a space to appear in a 
menu word, you must type an underline character instead of a space. 

The program for each menu contains two sequences of items. 


e The first shows the words to be displayed in the menu: 


(Quit_123 | Retrieve | Save) 


e@ The second shows the corresponding key codes to be executed: 


(/q | /fx | /f£s) 
Some keys are special: (1), (Ctrl), (Spacebar), (1), 0), (1), and the number keys. 


To put them into a sequence, use the corresponding ASCII code (see Appendix B of the 
POINT Editor User’s Manual, or see the IBM PC BASIC Manual). 


For key code meanings in the second sequence, check the Command Summary in 


Chanter 2 of the Lotus 1-2-2 Reference Manual, 


The Point & Click Shell 


Menu for READY mode: 
(Save | 
Retrieve | 
Home | 
End_Home | 
Sum_Column | 
Sum_Line | 
Print Range | 
Worksheet Fmt | 
Column Width | 
Insert _Row | 
Insert Column | 
Days | 
Months | 
Transpose_ HV | 
Transpose VH | 
Erase Right | 
Erase Down | 
Center Label | 
Today | 
Fast_Quit 
} 


(/FS | 

/FR | 

O71 | 

079 O71 | 

@SUM 40 072 . 079 072 41 13 | 

@SUM 40 075 . 079 075 41 13 | 

/ppr | 

/wof | 

/wes | 

/wir 13 | 

/wic 13 |} 

Mon 077 Tue 077 Wed 077 Thu 077 Fri 077 Sat 077 Sun 13 079 075 

Jan 077 Feb 077 Mar 077 Apr 077 May 077 Jun 077 Jul 077 Aug 077 Sep 077 Oct 077 
Nov 077 Dec 13 079 075] 
/rt 079 077 13 13 | 

/rt 079 080 13 13 | 

/re 079 077 13 | 

/re 079 080 13 | 

060 071 * 083 13 | 

@NOW 13 /rfd 13 13 | 


/ay 
} 
Menu for other modes: 
(Return | Anchor | Home | End_Left | End_Right | End_Up | End_Down | End _Home 
) 
(13 |. | O71 | 079 075 | 079 077 | 079 072 | 079 080 | 079 071 ) 
Right Button is ESCAPE: 
(27) 
Plus & Minus Keys: 
(O80 {| 077) 


delete the above line if you want the regular plus and minus 
(+{-) 


Figure M-1 M123.MEN Source File 
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You can modify an existing Point & Click Shell menu by inserting a new option in its 
first sequence, and the corresponding key codes to be executed in the second sequence. 
For Point & Click to find the second item, it must be in the same spot in the sequence. 


To add the option "Split_Window" in the main menu: 


Step 1: Open M123.MEN for editing. 


Do this with the POINT Editor, or the non-document mode of a word 
processing program like WordStar.) 


Step 2: Insert the Menu Item Name. 
In the first sequence of entries, on line 9, type: 
Split Window | 


Note: Include an _ (underline character) between Split and Window 
in order to separate those words by a space in the menu on screen. 


Step 3: In the second sequence of entries, on line 9, type: 
/weh | 
This is the Lotus 1-2-3 command for /Worksheet Window Horizontal. 
Step 4: Save your revised M123.MEN file. 
Your revised M123.MEN file should match Figure M-2. 


For (QO mi), and for (4) and (©) , the ASCII code entries tell which keys are to be 
executed. These can be modified by replacing the existing items with new ASCII code 


antrina 
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Menu for READY mode: 
(Save | 

Retrieve | 

Home | 

End Home | 
Sum_Column | 
Sum_Line | 
Print_Range | 
Worksheet_Fmt | 
Split Window | 
Column Width | 
Insert _Row | 
Insert Column | 
Days | 

Months | 
Transpose HV | 
Transpose_VH | 
Erase Right | 
Erase Down | 
Center Label | 
Today | 
Fast Quit 

} 


(/FS | 

/FR | 

O71 | 

079 O71 | 

@SUM 40 072 . 079 072 41 13 | 
@SUM 40 075 . 079 075 41 13 | 
/ppr | 

/waft | 

/wwh | 

/wes | 

/wir 13 | 

/wic 13 | 

Mon 077 Tue 077 Wed 077 Thu 077 Fri 077 Sat 077 Sun 13 079 075[ 
Jan 077 Feb 077 Mar 077 Apr 077 May 077 Jun 077 Jul 077 Aug 077 Sep 077 Oct 077 
Nov 077 Dec 13 079 075] 

/rt 079 077 13 13 | 

/rt 079 080 13 13 | 

/re 079 077 13 | 

/re 079 080 13 | 

060 071 * 083 13 | 

@NOW 13 /rfd 13 13 | 


/ay 
) 
Menu for other modes: 
(Return | Anchor | Home | End_Left | End_Right | End_Up | End_Down | End_Home 
) 
(13 | xe | O71 | 079 075 | 079 077 | 079 072 | 079 080 | 079 071 } 
Right Button is ESCAPE: 
(27) 
Plus & Minus Keys: 
(080 | 077) 


delete the above line if you want the regular plus and minus 
(+|-) 


Figure M-2 Modified M123.MEN File 
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Section 7 Troubleshooting 


The interaction of the LOGITECH Mouse, the Point & Click Shell, and Lotus 1-2-3 
should be trouble-free. Although they are unlikely, some possible problems and their 
solutions are described below. 


Mouse cursor is not visible 


Move the mouse. The cursor should reappear as soon as the mouse moves. 


Mouse cursor will not move 


Check mouse connections. If the mouse is properly connected, make sure that 
the 1-2-3 or Printgraph printer settings are not on the same serial port as the 
mouse. Correct and reload the mouse. 


Mouse cursor leaves inappropriate character on screen after you move the mouse 


This happens occasionally when a long operation has taken place and its 
necessary for Lotus 1-2-3 to repaint the screen. Spreadsheet content is not 
affected. 


Point & Click Shell will not work with special screen sizes 


The Point & Click Shell does not work with the following video modes: 


Hercules 90 x 38 
AT&T 80 x 50 


nts: 
C7 


Darian TF a 19 DF imntntl at 
ANU VELDY AULD 2m 


Aw tr wan asthnw 
A2L1OC UY VILLI 


Hercules 80 x 25 or 
AT&T 80 x 25 
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POINT EDITOR 


Introduction 


Introduction 


This introduction gives you an overview of the POINT Editor, and tells you how to read 
the manual, as well as providing some information about LOGITECH products and 
product support. 


How the POINT User’s Manual is Organized 


This manual assumes that you are familiar with the basics of DOS and with basic 
programming concepts and terminology. 


This manual includes: 


Introductory information with system requirements and installation instructions. 
A step-by-step tutorial through the POINT Editor in Chapters 1 and 2. 

A complete reference for the POINT Editor in Chapters 3 through 6. 
Supplements and Quick Reference Guides in the Appendices 

An index. 


If you are a beginner, work through the tutorial to get started using the POINT Editor. 
Then consult the reference chapters for more detailed information. 
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How to Read This Manual 


The following conventions are used in this manual: 
Keys to be pressed, look like this: 
Control sequences or characters entered with a Control or Shift key, look like this: 
Keys from the Numeric Keypad are shown like this: 
(=) 
Keyboard input for the DOS Command line is in upper case and looks like this: 
PT 
Mouse buttons used are based on the LOGITECH standard, and use three buttons, e.g, 


{mi QQ} means press the left mouse button, 
(QO mi) means press the right mouse button, and 
[CQ ml OQ} means press the middle mouse button. 
(mm) refers to the middle button as implemented on a two button mouse. 
File names look like this: 


PT.INI 
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DOS commands and statements look like this: 
PATH, COPY 

Product names look like this: 
MS DOS, IBM PC 

Screen output and some listings look like this: 


Program Not Found 


Program code looks like this: 


IF condition THEN 
statement6; 

ELSIF condition THEN 
statement7; 


ELSE 
statement8; 
END; 


Sample Screens look like this: 


open close HELP #next prev WINDOW EDITING MOVING QUIT+ETC OPTIONS TOPLIST 


POINT Editor Version n.n Copyright 1987 LOGITECH Inc. All Rights Reserved 
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LOGITECH Policies and Services 


LMIS 


We know that effective communication with our customers is the key to quality service. 
Therefore we have set up the LMIS (LOGITECH Mouse Information Service), an 
electronic bulletin board where you can contact us at your convenience. 
To reach the LMIS, dial: 


(415) 795-0408 
using a 300, 1200 or 2400 baud modem. 


The menu of available options is self explanatory. 


BIX 


LOGITECH also sponsors an electronic conference on BIX, the BYTE INFORMATION 
EXCHANGE system from Byte magazine. If you have access to BIX, join us in 


conference LOGITECH, 


and communicate with us there. 


Getting Help through the Hotline 


You should rely on your manual or your dealer to answer questions about using your 
package. It you do encounter a technical problem with your package, our Technical 
Support Specialists will be glad to help you. 


We ask you to follow these steps before you call or write. 


@ Read the section of the manual that describes the procedure you are trying to perform. 


e If the problem relates to your software, check to make sure that the software is 
properly configured. 


If, after following these steps, you are still not able to solve the problem, give us a call at 
(415) 795-0427, or write to us. If you write, please include your daytime phone number 
and the best time to reach you. Also, please add "Attn: Technical Support" somewhere 
on the envelope. 


We want to help you make the most effective use of your package. 
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Other LOGITECH Products 


At LOGITECH we pride ourselves on technical excellence and advanced engineering. 
In addition to the POINT Editor, we offer these fine products which we believe to be the 
most advanced in their product categories. 


LOGITECH Modula-2 Development System 


The LOGITECH Modula-2 Development System gives you the most powerful 
software development environment available for your PC: 


@ The LOGITECH Modula-2 User’s Manual with tutorials, a Compiler that 
generates standard .OBJ files, a Symbolic Post-Mortem debugger, and a 
complete listing of the LOGITECH Modula-2 libraries. 

e@ The LOGITECH Modula-2 Toolkit includes the enhanced LOGITECH 
Linker, a Symbolic Run-Time Debugger, and the perfect combination of 
utilities to optimize both your development environment and your Medula-2 
code. 

@ The LOGITECH Turbo-Pascal To Modula-2 Translator. 

@ A VAX/VMS version of LOGITECH Modula-2. 


Site licenses are available for all LOGITECH Modula-2 products. 


The LOGITECH C7 Mouse 


The LOGITECH C7 Mouse connects to a serial port in your computer. 
It needs no pad and no external power supply. 


The LOGITECH Bus Mouse 


The LOGITECH Bus Mouse is equivalent to the LOGITECH C7 Mouse, 
except that it is connected to a Bus Board which you insert in your computer. 
It needs no pad and no external power supply. 


For additional information, or to order these products, call the LOGITECH sales office 
toll-free from anywhere in the continental U.S. at (800)231-7717, or 
in California, call (800) 552-8885. 
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Installation 


This chapter tells you how to install the POINT Editor on your system and create an 
optimal environment for your editing tasks. 


What You Need 


To install the POINT Editor you need: 


An IBM PC/XT, AT, PS/2 or compatible computer, with 


256 K RAM memory (POINT Editor uses 140 K) 
Two (2) 360 K disk drives, or a hard disk and at least one (1) 360 K disk drive. 
PC DOS or MS DOS 2.0, or above. 


A LOGITECH mouse is definitely recommended. 


If you are not using a mouse, refer to Appendix E for instructions on keyboard 
emulation of mouse actions. 


IMPORTANT 


READ.ME on one of your LOGITECH disks has information about this version 


of the POINT Editor that was not available when the manual was prepared. 
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POINT Files on Disk 


The following POINT files are on your LOGITECH distribution diskette. 


* 


PT.EXE 
PT.INI 
PT.MSG 


PT.HLP 


The executable file for the editor. 
The initialization file. 
The message file, contains a one line description for each command. 


The help file, gives an extensive summary and detailed descriptions 
of commands and menus. 


* indicates files needed to run POINT. 


Additional files issued with the POINT Editor are used as follows: 


PTEXPERT.INI 


COLOR. INI 


MONO.INI 


READ.ME 


The color initialization file. If you have a color monitor, copy 
COLOR.INI to PT.INI. 


The monochrome initialization file, this file as well as the original 
PT.INI is set up for monochrome monitors (also for black and white 
monitors running with the color card). 


Te ...- | ee 
aL 


monochrome monitor, copy this file back into PT.INI. 


The expert user initialization file. Copy this file into PT.INI when 
you are more familiar with the POINT Editor. 


Alternate .INI files can be copied to the name PT.INI for customizing 
your POINT system. See Chapter 4. 


This file contains information that was not available when POINT 
documentation was prepared. 
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Installation Procedure 


NOTE 


Before you install your software to either floppy drive or hard disk system, 
we strongly recommend that you take a minute to: 


1) Put Write-Protect tabs on all your LOGITECH diskettes, and 


2) Use the DISKCOPY and DISKCOMP commands from your DOS files to 
back up your diskettes. Then put your original diskettes in an archival area 
and use the copies for all installation. 


Prepare formatted diskettes with readable labeling, before you copy the the 
files in the Installation procedure which follows. 


Hard Disk System 


If you have a hard disk, run the INSTALL program from drive A. It will transfer the 
appropriate files to the directory you specify, or to a default directory. 


Floppy Disk System 
For a floppy diskette system, format a target diskette with your DOS system for drive B. 
Then put the copy of your LOGITECH diskette into drive A, and type, 
A:INSTALL 
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Configure Your System 


Set File Handles 


You can edit several files at once. POINT lets you include up to 20 file names on the 
command line when you invoke POINT. A file handle is needed to work with each file. 


If you plan to edit several files at the same time, be sure you have enough file handles. 
Put this line in your CONFIG.SYS file: 


wr AA 


FILES=30 


This gives you 30 file handles instead of the default of 8. The resident part of DOS is 
only increased by 40 bytes for each file above 8. This is more than enough for most 
purposes. 


Load Your Mouse Driver 


Before you run POINT, if you have a mouse, load your mouse driver. Use 
MOUSE.COM or MOUSE.SYS. Refer to your mouse manual for instructions. 


If you don’t have a mouse, refer to the non-mouse equivalent tables in Appendix E. 


POINT and Your Monitor 


If you have a monochrome or Hercules compatible display, leave PT.INI as it is on the 
diskette or in the current directory. 


If you have a color display, copy the COLOR. INI file to PT.INI on the diskette or in the 
current directory. 


If you have a color graphics adapter you may see display interference (snow) on the 
screen. Press and to check for display interference on the screen. If you 
see display interference, reset the videoMode option. To reset the videoMode you will 
have to change one parameter in the PT.INI file. Refer to Section 4.3. 
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Chapter 1 
Begin the Tutorial 


Welcome to the POINT tutorial. 


When you finish this chapter you will know how to load the POINT program files, how 
POINT screens and menus work, and how to manipulate windows and files with the 
POINT Editor. 


If you haven’t done the setup procedures, go back now and configure your system so you 
can understand what follows. 


Remember to include the POINT sub-directory in your PATH statement and make sure 
you are in the POINT sub-directory before you begin this tutorial. 
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1.1 Load the POINT Editor 


To load the POINT Editor, type: 
PT 


You will see the initial POINT screen. The top line of the screen is the main menu, the 
body of the screen is the work area (for loading and editing files), and the bottom line 
(when you first call the POINT Editor) displays the version and copyright notice: 


open close HELP @#next prev WINDOW EDITING MOVING QUIT+ETC OPTIONS TOPLIST 


POINT Editor Version n.n Copyright 1986 LOGITECH Inc. All Rights Reserved 


NOTE 
To quit the POINT Editor and return to DOS, press [Q) 


Since this is a tutorial, don’t exit just yet. If you have exited, please re-start the editor. 
Refer to Section 6.8 for more information on quit commands. 
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1.2 The Parts of the Screen 


When the POINT Editor starts, it creates a screen with: 


@ The main menu at the top of the screen; 
e@ A blank work area where one or more windows can be opened and edited; 
@ Acomment line (with the copyright notice) at the bottom of the screen. 


NOTE 


The comment line alternates between simple help reminders and command 
prompts. It changes when you move the cursor to the top line of the screen. 
Occasionally it disappears entirely. 


Move the blinking cursor along the main menu at the top of the screen. Observe 
how the copyright notice disappears from the comment line and is replaced by 
a short description of commands. 


1.2.1 Cursor, Selection, and Insertion 
There are three primary primary functions on your POINT screen: 


Selection cursor A blinking square that can be moved by the mouse — or, if 
you have no mouse, by keypad cursor keys — to either select 
a new insertion point, or so select a command outside the text 
window. The new selection or command is then implemented 


with (and sometimes also with ): 


Selection An area of text that is highlighted for purposes of 
manipulation, or for indicating the insertion point. 


Insertion point The area at the beginning of the selection at which new 
characters appear from your keyboard, or as the result of a 
move or copy operation from another area of text (from the 
same window, or even from a different file in another 
window). 


One last word here: the insertion point is set either to add 
characters at the insertion point (OverType=0) or to replace 
existing text with new text (OverType=1). 
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1.2.2 The Main Menu 


The main menu is on the top line of the screen. It contains pull-down menus and 
commands. Menus, such as WINDOWS, are in upper case, and commands, such as open, 
are in lower case. 


Each pull-down menu contains a list of commands and/or menus. 


Each command presents choices or prompts, or performs a function. 


1.2.3 The Work Area 


The work area (the large blank area) of the screen is where you load and edit files. 


1.2.4 Comment line 


The comment line (the bottom line) displays one line comments, explanations, or 
command prompts for the pull-down menus and commands that you use. 
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1.3 The HELP System 


The comment line offers a simple level of help. For additional help, move the mouse 
cursor to the HELP menu on the top line and click . A help screen will appear 
which gives details on the last command executed or highlighted. 


You can return to your editing session from this help screen, or get additional help. To 


exit the help system, either click or press the : , oF Pel Ws 


access the main help menu, press 


From the main help menu you can get additional help screens. Use the mouse cursor to 


pinpoint the subject you need. Then click the mouse button, or press 
A help screen with additional information will appear. 


Some help screens let you access additional help screens with specific information about 
particular subjects. You can access these screen by pressing a letter or key from the 
More info column which corresponds to the subject matter you choose. 


or gets the next help screen, and or gets the previous 


help screen. 


If there are no more related help screens, takes you back to the main help menu. 
From this menu you can access any of the help screens, or exit the help system. 


1.3.1 Yes/No Questions 


When answering yes or no questions, either Y (yes) or N (no) is shown as a default 
answer. You can accept the default with the key. Or, you can press(Y} or(N)as an 
answer, without pressing : 


You can also use the mouse to answer Yes/No questions: simply move the mouse cursor 


to the bottom of the screen. Then press for Yes or for No. The mouse 


cursor must be on the bottom line to be able to answer yes or no. 
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1.4 Look at Menus 


The following exercises show screen layout and available commands. 


1.4.1 Open a File 
Let’s explore menus and screen options by opening a window and loading a file. 


Step 1: Put the cursor on open on the main menu. Now click| ™ OQ QO] twice. 
A screen appears, with: 


@ Directory and file information on the top line 

@ Additional commands on the second line 

e@ A list of the files in the current disk drive and directory 

@ A prompt which lets you enter a file name from the keyboard. 


CD=c:\temp Pattern=*.* Number of files=# 


Cancel load Next page Previous page New pattern Change 
drive 


Click on a command (above, CLICK on a file name (below), or TYPE in the name. 
\ 


read.me 


File to load into the new window: 


Step 2: Place the mouse cursor on read.me. Click 


The file you just selected now appears inside a window in the work area. Now 
you can explore the rest of the the POINT system. For this tutorial we will use 
this READ.ME file from the POINT sub-directory. 
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1.4.2 Explore a Pull-down Menu 
The following steps show you how to choose a command from a pull-down menu. 


Step 1: Move the mouse cursor to the top line of the screen and put the it a menu. 
WINDOWS, EDITING, MOVING, QUIT+ETC, OPTIONS, and TOPLIST are 
menu names. 


Step 2: Press and hold the mouse button on the menu name you have selected. 
This pulls down a menu under the selected menu name. 


Step 3: While pressing , "drag" the cursor into the pull-down menu and down 
the screen. 


Menu items are highlighted as you move the cursor inside the menu. Notice 
how the comment line changes to reflect the highlighted command inside the 
menu. 


Step 4: Move the cursor outside the menu and release the button. This releases the 
menu without executing a command. 


NOTE 
To choose and execute a menu command, release the button when the 


desired command is highlighted. 
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1.5 Create a New Window 


In this exercise you will create a new window, and load a file into that window. This 
procedure is similar to the open command, but is done from the WINDOWS menu. 


Leave the READ.ME file on the screen. 


Step I: 


Step 2: 


Step 3: 


Step 4: 


Select WINDOWS and then drag the mouse cursor down the screen to highlight 
New Window. The following message appears on the comment line: 


Press the left mouse button at one corner. 


Put the mouse cursor in the middle of the screen and hold down the ; 
Move the cursor to the lower right screen corner. An elastic window border 
follows the mouse cursor until you release the button. You have just defined the 
position and size of the window on the screen. 


NOTE 


If you double click at the upper left window corner, the lower right 
window corner goes automatically to the lower right corner of the screen. 
The new window then covers the current window. Don’t worry: the 
READ.ME file is still there. Go on with the remaining steps. Later you 


will see how to handle overlapping windows. 


Once you choose the two corners, you are shown a screen with a 
selection of file names from the current directory. 


Select a file to load into the window by clicking on it with : 
or by typing the file name on the keyboard at the comment line prompt. 


For this tutorial, type in BRAND.NEW from the keyboard. As you type in the 
characters they appear at the end of the comment line. When the name is 


complete, press 


You return to the editing screen and are asked to confirm the file creation with a 


y’. 


When you type[ Y] , a window appears with the borders you defined in Step 2. 
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1.5.1 Look at the Parts of the Windows 


Take a minute to look at the windows you now have on the screen. 


NOTE 


If and ONLY if your windows are overlapping, go to Section 1.9, Reshape a 
Window. Follow those procedures to resize the overlapping window. 


Then return here and continue. 


Each window has a banner line, an elevator, and a border. 
Each banner line (at the top of the window) has: 


e The name of the file in the window. 
e@ The line and column ranges in that window. 


Each window elevator (in the left border) shows: 


e@ Where in the file you are currently looking. 
e How much of the file is being displayed. 


The window border shows which is the active window: 


e@ The current or active window has a double line border. (See Section 5.2.1) 
@ The active window is affected by POINT commands. 
e@ An inactive window has a single line border. 


Put the mouse cursor on the READ.ME window. Click (QQ). The READ.ME 
window is now active. 


Toggle between the two windows on the screen by clicking on the banner line of each 
window. As you do this, see how the borders change. 
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1.5.2 Close the Window 
When you finish editing a file, clear it from the working area. 


Step 1: Make the READ.ME window active. 


Step 2: Now, close the window in one of three ways: 


@ Use to pull down the WINDOWS menu; 
release it on Close Window. 


e Click({m™ Q QJ onclose on the top line. 


e Press[ Alt HC}. 


Each method closes the active window and clears it from the screen. The BRAND.NEW 
window is left on the screen, and automatically becomes the active window. 


If the window to be closed has been edited, a comment line prompt shows the drive, the 
path name if any, and the file name, along with the option to save or discard edits. 


The default is(Y] to save. For this tutorial press(N) . 
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1.6 Open Multiple Windows 


Multiple windows are useful when editing several files. Now you will open multiple 
windows and see how they exist simultaneously on the screen. 


Step I: 


Step 2: 


Step 3: 


Step 4: 


Select WINDOWS with the mouse cursor and choose New Window. A message 
on the comment line asks you to: 


Press the left mouse button at one corner 
Press and hold near the upper left corner of the screen. An elastic 


window border will follow the mouse cursor until you release the button at the 
lower middle section of the screen. When the list of file names appears, type: 


READ.ME 


Repeat Step 1 and Step 2; only this time define the window, starting from the 
upper right hand corner. 


You now have three windows on your screen: two loaded with the file 
READ.ME and one with BRAND.NEW. 


If only two windows are visible on the screen, put the mouse cursor on 


TOPLIST and hold down the mouse button, or press or (mw) 
or to view the list of files loaded in windows. 
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1.7 The TOPLIST Menu 


1.7.1 The Active Window 


When you have several windows on the screen, you need to find the active window, i.e., 
the window affected by menu and keystroke commands. Only one window can be active. 
It has a double-line along the borders and in the banner. Non-active windows have single 
line borders and use blank fill characters in the banner. 


mane SSR ew VAS Anne WesHe Kwewei’ 246 wsse UG. 


To set the active window: 


anywhere along the banner of any window. 


1.7.2 Overlapping Windows 


POINT lets windows overlap and obscure other windows. Think of the windows as 
sheets of paper on the screen. The top page can be seen completely and the lower pages 
may be partly or wholly hidden by windows above them. You can choose windows by 


clicking on any window corner. 


This moves a window to the top of the stack, but does not change its position on the 
screen. If the window is already the top window, this sends it to the bottom of the stack. 


Alt }B Jalso sends the active window to the bottom of the TOPLIST stack. 


TOPLIST makes it easy to switch between windows. TOPLIST also makes it easy to 
keep irack of which flies you are actuaiiy using and where they are in the work area. 


From anywhere below the top line of the screen press for the TOPLIST menu. 
To select an active window with TOPLIST: 


Step 1: Press(Q m Q). This invokes the TOPLIST menu. 


Step 2: Highlight the file name you want with the mouse cursor, and release the mouse 
button. The name you highlighted becomes the active window and moves to the 
top of the stack of windows. This is called Topping. 
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1.8 Move a Window 


Sometimes you must move a window to uncover another window, or make room for an 
additional window: 


Step 1: Select a window. 
Press and hold on the banner line of the window. A shadow version of 
the window border follows the mouse. 


Step 2: Move the window against the bottom edge of the screen and watch the border 
get smaller. The border expands to its original size as you move away from the 
bottom of the screen. 


Step 3: Release while the shadow window is smaller, to reduce the size of the 
window. If the final size of the window is too small, the move will be canceled. 


NOTE 


A window can also be moved on the screen simply for better viewing, 


without reducing its size. 
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1.9 Reshape a Window 


Sometimes you need to make a window larger or smaller. Here are three ways. 


1.9.1 Resize a Window 


: Activate the window you want to resize, as discussed in Section 1.9.1. 


1 
Step 2: Select Resize Window in the WINDOWS menu. A prompt in the comment line 
now requests two opposite corners of the window. 


Step 3: With the cursor anywhere on the screen, press and hold(m OQ Q). 
An elastic window now follows the cursor to the desired size and shape. Then 
release the button: the window and its contents will take the shape, size and 
position you have just specified. 


NOTE 
You can specify either pair of opposite corners for the window (not just 


the upper left and lower right corners). 


1.9.2 Stretch a Window 
Stretch is faster than Resize for repositioning windows. 


Step 1: Put the mouse cursor on any window corner and press the (QO mi). 


Step 2: Still holding down the , move the mouse cursor. An elastic border 
follows the mouse cursor until you release the button. 


Step 3: Repeat Step 1 and Step 2 using a different corner. 
1.9.3 Zoom a Window 
Zoom Window toggles between a full-screen active window and a multi-window screen. 


Step 1: Select the smallest window to Zoom and make it the active window. 


Step 2: Press , or select Zoom Window from the WINDOWS menu. 
Repeat to unzoom the window. 


Begin the Tutorial 


1.10 View a File 


A window often shows only part of a text file. Scrolling "moves the window" vertically 
or horizontally over the file so you can see different areas of the text. 


1.10.1 Scroll With the Mouse 


To scroll vertically: 


Step 1: Place the mouse cursor on the left border of the window. 


Step 2: Click to scroll down, and to scroll up. 


The farther down the left border the mouse cursor, the further the window scrolls. More 
precisely, moves text beside the mouse cursor to the top line in the window. 
moves the top line to where the mouse cursor is on the left margin. 


Watch the the banner line change and the elevator move along the left window border. 


To scroll horizontally: 


Step 1: Place the mouse cursor on the bottom border of the window. 


Step 2: Click to scroll right and to scroll left. 


Notice the changes in the columns indicator on the banner line. 
1.10.2 Thumb with the mouse 


Thumbing is like holding a book or magazine so you can flip through it with your thumb. 
Similarly, you can use the mouse to move the window to any part of the file by thumbing. 


Imagine that the left window border (but not the corners) is the whole file. Now move 


the mouse cursor to the center of the left border. Press : the elevator moves to 
the center of the border and the window jumps to text in the the middle of the file. For 


text at the end of the file, press near the bottom of the window’s left border. 


When text in the window is out of range on either left or right border, press 
anywhere along the bottom border to thumb horizontally back and forth. 


NOTE 
| Don’t try to scroll or thumb window corners. Corners have different commands. | 
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1.10.3 Scroll with Cursor Keys 
or also scrolls the window up or down. 


| PgUp} moves a window to the beginning of the file. 


[PgDn} moves a window to the end of the file. 


NOTE 
With or a window is scrolled n-2 lines. 


This means a window with 74 lines moves up or down 12 lines, with 2 lines of 
reference to the previous screen. 
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1.11 Save Files 


Editing space depends on the number of changes you make to the files you edit, rather 
than the size of the files edited. When editing space gets crowded, the SAVE message 
appears in front of the file name in each window. 


When SAVE appears, save edited files to regain editing space. If you don’t save the files 
as soon as you see this message, you risk losing your edits. 


Use Save File from the WINDOWS menu or : 


1.11.1 The Save As ... Option 


Sometimes you want to keep the changes in a file separate from the original file. In this 
case, save the changed file under a different name. This makes it possible for you to 
have both the current file under a different name and the original file under its old name. 


Thus, if you make changes to READ.ME and want them saved separately, do this: 


Step 1: Make one of the READ.ME windows active by putting the cursor on the banner 
line and clicking (m™ Q Q), 


Step 2: Choose Save as... from the WINDOWS menu or press . The 
comment line will display: 


Step 3: Type READ.YOU 
The file in the active window will be saved as READ. YOU. 


Step 4: Close the current window with ; 


Step 5: Open a new window, using open, or WINDOWS/New Window. 
READ.YOU will appear in the list of files in the directory. 


Step 6: Load READ.YOU by clicking on the name from the list, or by typing it 
on the comment line prompt. READ.YOU now appears in the banner line of the 
new window. 


You now know how to create and manipulate windows with POINT. 


The next chapter will show you how to edit and manipulate files. 


Chapter 1 


Notes: 
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Edit With POINT 


This chapter lets you edit and manipulate files with keyboard commands and with the 
EDITING menu. 


Using the files from the previous chapter, open a window and load a file. Use more than 
one window if you desire. 


2.1 Insert New Text 


When you type, characters are inserted immediately to the left of the selection highlight, 
which then is "pushed ahead” of the cursor. 


To insert a new line, press 


To start a blank line, select the end-of-line character of the preceding line. Find it by 
clicking the anywhere to the right of the last visible character on the line. 
The rectangular highlighted blank contains the Carriage Return character. 


Now press 
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2.2 Select Text 


Text can be deleted, moved, copied in and between files, or it can be temporarily stored 
in a scrap buffer. The first step for any of these actions is to select the text. 


2.2.1 Select Characters 


Point at text with the mouse cursor and click 


If you press and hold while you move the mouse cursor (in either direction) you 
can select any number of characters. If you extend the selection, once the 
mouse button is released, the selection will start again from where the mouse cursor is 
currently positioned. 


To extend the current selection, hold down the and move the mouse cursor. The 
selection is extended leaving the originally selected text highlighted. 


NOTE 


There is a non-displayable character at the end of each line that is “displayed” as a 
blank. You can see it only when it is part of a highlighted selection. (Select over 
several lines so you can see it.) . 


This is the end-of-line character. It represents the Carriage Return character or 
the key that ends each line. If you delete the end-of-line character, that line 
fastens itself immediately to the first character of the following line. 
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2.2.2 Select Characters, Words, and Lines 
A selection extends from character to word to line, and back again to character. 


Select a single character (in a word) with the blinking mouse cursor and click the 
(™ QO O}button. Click again to extend the selection from character to word. Click again 
to extend the selection from the word to the entire line. A final click returns you to the 
original character you Selected. 


To extend the selection by character, word, or line, hold down the mouse button on the 
last click and move the cursor up or down in the file. 


Step 1: Click on any character in the text. The character is highlighted. 
Step 2: Click on the same character. The whole word is now highlighted. 


Step 3: Click and hold down on the same character. Now the entire line is 
highlighted. 


Step 4: Move the cursor up or down to extend the selection. Notice how the selection is 
highlighted line by line. 


NOTE 


If you hold down on any click, you can extend the selection based on the 
original selection mode, (character, word, or line). Extending the selection with 
will also be based on the original selection mode. 


~ And remember — nothing happens until you execute a command. If you select 
the wrong amount of text, nothing will happen. Just start the selection over. 
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2.2.3 Click Method for Selecting Text 
The click method is useful for selecting large areas of text. 


Step 1: Click at the beginning of the desired text selection. 


Step 2: Move to the end of the desired selection. (You can scroll or use any other 
window moving commands to do this.) 


Step 3: Click(QQOm). 
The text between the (ml OQ QJand|Q QO MJclick is now highlighted. 


starts the selection. extends (or contracts) the selections. You can also 
extend the selection by holding down the and moving the cursor. 


2.2.4 Hold Down Button Method for Selecting Text 
This method is convenient for selecting small portions of text. 


Step 1: With the cursor at the front of the text to be selected, press and hold 


Step 2: Still holding , move the mouse cursor to the end of the desired 
selection. The selection will follow the mouse cursor. 


Step 3: Release when your selection is highlighted. Remember, use to 


extend or shorten your selection. 


Now that you know how to select text, the following sections explain how to manipulate 
the text you have selected. 
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2.3 Move and Copy Text 


Moving and copying text are different: text that you move is deleted from its original 
location and inserted to a new one; text that you copy stays in its original location and is 
duplicated at a new location. 


There are several ways to move and copy text. The simplest way is with and ; 


2.3.1 Move or Copy Using "The Scrap" 


and (Ins} are useful for moving and copying text when you want to move small 
portions, or make several quick copies of text, but impractical for moving or copying 
large portions of text. Move and Copy are better for moving and copying large portions 
of text. 


Step 1: Highlight the text you wish to move or copy. 


Step 2: Press or(F1]}. This deletes the selection to the scrap buffer. The scrap 
buffer holds the last section of deleted text until you are ready to insert it into 
another area of your text, or to replace it with another delete action. 


Step 3: To keep text in its original location, re-insert it immediately with the(Ins) key. 


Step 4: Move the mouse cursor to the place where you want to copy the text and click 
the button. You are about to insert text in front of the cursor. 


Step 5: Press(Ins)or(F2). This inserts text from the scrap buffer to the insertion point. 


2.3.1.1 Multiple Copies from the Scrap 


Inserting text does not empty the scrap buffer; it merely copies its contents to the 
insertion point you choose. This means you can copy the same text as needed. 


To make five copies of a line: 
Step 1: Highlight the line. (triple click (i OQ Q)on the line) 


Step 2: Delete the line: press once. 
Step 3: Insert it five times: press five times. 
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2.3.2 Move or Copy Without the Scrap 


Text that you move is deleted from its original location and inserted to a new one; 
text that you copy remains in its original location and is duplicated to a new location. 


There are two ways to move text: 


e (mi OO); and 
e Extract (F5) F 

There are two ways to copy text: 
@ (fShift} m QQ); and 
@ Duplicate . 


2.3.2.1 Move Text, the Ctrl-Mouse Method 


Step 1: Highlight the text to be moved. 


Step 2: Move mouse cursor to the point where you want to move the text. 


Step 3: Press and click the mouse button. When you release the 
mouse button, the text you chose in Step 1 will be inserted (moved) just in front 
of the mouse cursor to the insertion point. 

2.3.2.2 Move Text, the Extract Method 


Extract is used for moving text to a pre-selected insertion point. 


Step 1: Highlight the point at which you want the text inserted. 


Step 2: Press(F5}. 
Step 3: Now find the text you want moved and highlight it. 


Step 4: Press again. The text you just chose in Step 3 is automatically moved to 
the insertion point you chose in Step 1. 


D - 34 
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2.3.2.3 Copy Text, the Shift Mouse Method 


Copy requires that you select the text before you select the insertion point. Then (after 
you Select the text to be copied and before you copy it) scroll or thumb the window to 
where the text will be copied. (The text to be copied does not need to be visible in a 
window at the time of the copy.) 


Step 1: Highlight the text to be copied. 


Step 2: Move the mouse cursor to the point where you want to copy the text. 
Step 3: Press(fShift) and click the button. The text will be copied to the place 


just in front of the mouse cursor. 
2.3.2.4 Copy Text, the Duplicate method 
Duplicate lets you copy text to a preselected insertion point. 


This method lets you build lines from pieces of other lines without disturbing the 
borrowed text. 


Also, you do not lose the insertion point when selecting text. 


Step 1: Select an insertion point in the new window witha click. 
Step 2: Press(F4). 

Step 3: Highlight the text to be copied. 

Step 4: Press to copy highlighted text to the insertion point. 

Step 5: To copy additional text, repeat Steps 2 through 4. 


NOTE 


This concludes the step-by-step portion of the tutorial. The remainder of this 
tutorial explains the editing commands invoked from the EDITING, MOVING and 


QUIT+ETC menus. 
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2.4 The EDITING Menu 


2.4.1 Redo Last Edit 


Choose Redo Last Edit from the EDITING menu. It offers a quick way to repeat 
the last edit action performed. 


The effect of Redo depends on the last editing action: 


Copy 

Move 

Insert 
Delete/Insert 


Delete 


Text copied in the last edit is copied to the selected insertion point. 
Text moved in the last edit is moved to the selected insertion point. 
Text most recently typed is inserted at the selected insertion point. 
Text is deleted and replaced with previously inserted text. 


Only possible when followed by an insert. 


Select a word, delete it, and type a different word. Then select a second word and choose 
Redo Last Edit from the EDITING menu, or(F8). 


Notice: the second word is replaced with the same text as the first word. Redo repeats 


(ins } as one action. 
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2.4.2. Undo Last Edit 
To undo the last edit, choose Undo Last Edit from the EDITING menu, or press : 
Practice undoing some edits: Delete text, undo it; insert text, undo it; select a word, 


delete it and type in a different word. Now undo that. 


NOTE 
is defined as one action, and is undone as one action. 


2.4.2.1 Undo (reversible) the last edit. 


The last edit is undone, that is, its effect is nullified. The undo undoes the previous undo. 
This lets you switch between two versions and compare . You can undo any number of 
times switching between the two versions. 


The effect of an undo on the various edits: 


Copy Copied text is deleted. 
Move Text that was moved is moved back. 
Delete Deleted text is reinserted. 
Insert Inserted text is deleted. 
Delete/Insert Inserted text is deleted and the deleted text is reinserted. 


This undo is considered an edit, so a second undo undoes the effect of this undo. 
Undo can temporarily toggle between two versions of the same text. 


2.4.2.2 Undo Multiple Edits 
Undo Multiple can undo up to 50 previous edits. 
For this, use Undo Multiple from the EDITING menu or fShift : 


Be careful here: this undoes edits so that the undo cannot be undone. Thus, a second 
Undo Multiple undoes an additional previous edit. 
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2.4.3 Global Replace 


Replace is related to Search. It is called from the EDITING menu or with ; 
You are asked for the string to search for. Then you are asked for the string to replace it. 
Next, you are asked whether to perform the replacement from the selection to the end of 
the file (globally), or only within the selection. Finally, are asked if you want to verify 
each replacement. If you press (yes), you are asked each time the string is found 
whether you want it replaced. 
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1e ignoreCase and searchMode options. 


2.4.4 Insert ASCII Character 


Insert ASCIT lets you enter any ASCII character into your file. You must specify 
the character by its numeric value. 


Type in the number of the character where desired in your text. Then highlight the 
number and select Insert ASCII. The ASCII character you defined will take the place 
of the number you typed. 


Specify the numeric value in decimal, octal, or hexadecimal form: 


Hexadecimal _ If the first two digits of the number are OX, 
then the rest of the number is hexadecimal. 


Octal If the first digit is 0 and the second is not X, 
then the rest of the number is octal. 


Decimal _If the first digit is not 0, 
then the number is decimal. 


Refer to your DOS or BASIC manual! for further information on ASCII codes. 
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2.5 The MOVING Menu 


2.5.1 Search for Text 


The POINT Editor lets you search for words, phrases and other strings quickly, 
conveniently, and accurately. 


When you invoke a search you are prompted for the string to search for. Type it in and 
end the string with the key. If the string is found, the window is moved (if 
necessary) and the string that was found is selected. 


A String search starts at the current selection and goes to the end of the file. Invoke the 
Search command with find on the top line menu, with Search for String from 


the MOVING menu, or with [Shift ; 


When the POINT Editor requests a search string it automatically enters the last string 
you searched for as the default string. accepts the default string, or you can modify 
it with . If you type any other character, the default string is erased and the 
string you type is used. 


Search for a string; accept the default string. Try it again; this time type a new string. 


You can also accept the default search string with the mouse. In general, acts 
like and can be used to accept the default string. then causes the action to 
be performed on the string once it is found. 


2.5.2 Crossing Windows 
You can also select a string in one window and search for it in another. Here’s how: 
Step 1: Highlight the string you wish to search for. 


Step 2: Make the window active where you want to search. 


Step 3: Select Search for String from the MOVING menu. 
If the selection is in the window, then the search starts at the selection. Otherwise, the 
search starts at the beginning of the file. 


To search for the next occurrence of the selection, use to select next from the 
main menu, Search for Selection from the MOVING menu, or press (F6) . 
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2.5.3 Search Backwards 
Searches backwards (towards the beginning of the file) for the selected string. 


Search Backwards is invoked from the prev command on the main menu, or from 


the MOVING menu, or with , or with . 


2.5.4 Search Options 


Several search options are offered by POINT. Refer to Section 6.4 for detailed 
descriptions. 
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2.6 The QUIT+ETC Menu 


2.6.1 Variations on the Quit Command 


There are three ways to quit that determine what is done with the your edited files. Each 
quit can be called from the Quit+Etc menu or from the keyboard. 


Quit and Ask 


(Ctri}{F3), LAlt HFS}, orAlt }Q) 


You are asked about each unsaved file. For each file, you must decide whether 
to save the edited version, or to discard it and keep the original. If you press 


in response to any question, Quit is abandoned and you return to the 
POINT editing session. 


Quit-Save files 


This automatically saves all edited and unsaved files and then exits to DOS. 
Quit and Discard Edits 


Shift 


This exits to DOS without saving any files, unless there are any recently edited 
but unsaved files. It asks you to verify these. 
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2.6.2. More Commands from QUIT+ETC 


2.6.2.1 Escape to DOS Shell 


Select Escape to DOS Shell from the QUIT&ETC menu, or press [D}. 
This gives you a DOS prompt to execute any DOS command. Then, to return to your 
POINT session, use the DOS EXIT command. 


2.6.2.2 Execute Selected DOS Command 


Alternatively, you can type a DOS command in a window, highlight it, and choose 
Execute Selected Command on the QUIT&ETC menu. The selection is taken as a 
DOS command and passed to the DOS interpreter for execution. The highlighted 
command is executed and the standard output of the command is sent to a window 
(which is created by the POINT Editor for this purpose). The window appears when the 
command is completed. 


The file name of the window is of the form UnNamed.x, where x is a letter in the range 
from a to z. 


2.6.2.3 Get Help 
This is an entry to the help system. From all help screens: 
Spacebar} Returns to editing. 
Esc} Returns to editing. 


Moves to the next screen. If there is no logical next help screen, you 
are returned to the general help menu. 


g gal 


Moves to previous help screen. 


2.6.2.4 Redraw the Screen 


The entire screen is redrawn. 
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POINT Concepts 


Chapters 3 through 6 provide a complete reference to the POINT Text Editor and 
describes many features not mentioned in the tutorial, Chapters 1 and 2. 


3.1 What POINT Is 


The POINT Editor is mouse-based, with overlapping windows and user definable 
menus, and is designed to run on IBM PC and compatible computers. It can manage up 
to 20 windows simultaneously and can be easily configured to your specific needs. 
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3.2 How POINT Works 


3.2.1 How POINT Works with a Mouse 


3.2.1.1 Mouse Cursor 


Since the POINT Editor only runs in text mode, the mouse cursor is a small block on the 


a t hy ¢ DAINT ditor. 
screen. It is controlled by your mouse driver, not by the POINT Edite 


3.2.1.2 Mouse Buttons 


The POINT Editor can be used by either a two-button mouse or a three-button mouse. 


Two-button commands are done by pressing , or(m im). on a 
Co) 


three-button mouse usually has the same effect as on a two-button mouse. 


is the main button. Use unless specifically directed to use 


-Sometimes you hold a button while moving the mouse. Other times you use the 
keyboard or with the mouse buttons. When you use ; , Or 
while clicking a mouse button, we recommend that you press and hold the key 
before you press the required mouse button. 


It’s not necessary to press and release simultaneously. Since action takes place 
when buttons are released, the POINT Editor monitors the buttons while they are down. 


When a button is down, if another button is pressed at the same time, POINT considers 
that they were hoth nressed, and invokes the command for both buttons. 


Practice this with "thumbing." Move the mouse cursor to the left window border. Then, 


while holding (™ QO Q), press . While still holding , release 
Finally, release (QO ml). This is the thumbing command, not scrolling. 
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3.2.2 How POINT Works without a Mouse 


If you work on more than one system, you will occasionally work without a mouse. 
For this reason, a non-mouse interface is included here. Although non-mouse use is only 
occasional, we have made it as close as possible to the mouse interface. 


Cursor keys move the mouse cursor, and other keys simulate mouse buttons. 


Mouse button keys simulate a completed click rather than a press or a release by itself: 
you can’t hold down a simulated mouse button. 


Some mouse commands are simulated by two keystrokes on the numeric keypad on the 
right side of the keyboard. 
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3.2.2.1 Mouse Movement Simulation 


The four cursor direction keys move the mouse cursor one row or one character. 


or moves one word at a time to the left or the right. 


"Word" here means a sequence of visible characters between two blanks. 


Fast cursor motion requires two keystrokes. The first keystroke is done with the 


Gray (+) ,(<), or on the numeric keypad. 
Starting with the Gray (+): 


and (—) keys move the cursor 10 columns left or right. 
and (__}keys move the cursor 6 rows up or down. 


: , and move the cursor 


diagonally 10 columns and six rows. 


Starting with the Gray (—): 
A cursor arrow key moves the cursor to the window edge. 
or moves to the top or bottom window border. 
moves the cursor to the right window border. 
moves the cursor to the window scroll border. 
Starting with (Homie) ; 
A cursor atrow key moves to one of the four screen edges. 
or moves to the beginning or end of the current line. 
, then (T_) moves to the top menu line. 


These commands move the mouse cursor only. They do not affect text selection. 
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3.2.2.2 Mouse Button Simulation 


Mouse button simulation also requires two keystrokes. The first keystroke is done with 
the key on the numeric keypad. 


Starting with the key: 


End simulates 
simulates 


simulates - 
simulates 


Gray simulates i 


simulates TShifttHO O my) 
simulates (mg OQ) 

simulates Ctri}{O m O) 
[PgUp | simulates CtrlHQO m) 
Gray (=] simulates Att Hm OQ) 


3.2.2.3 Using Mouse Keys with a Mouse 


Mouse simulation keys work differently if you use a mouse. 


Cursor movement keys move the mouse cursor and the selection. This is normally what 
you want when you have a mouse since it saves additional keystrokes to move the 
selection after the mouse cursor is moved. Since the selection moves, the screen must be 
redrawn after each cursor movement command. This makes these commands somewhat 
slower. 


If the cursorMouse option is set to 1, mouse cursor simulation will only move the 
mouse cursor even if a mouse is present. 
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3.2.2.4 Mouse Simulation Command Table 


First Key 


Gray 


First Key 


Gray (=) 


Moves Mouse Cursor... 


1 character left 
1 character right 
1 word left 

1 word right 

1 row up 

1 row down 


Cursor Moves... 


10 columns left 

10 columns right 

6 rows up 

6 rows down 

6 rows up and 10 columns right 

6 rows down and 10 columns right 
6 rows up and 10 columns left 

6 rows down and 10 columns left 


Next key moves within window to... 


Left edge of window 
Right edge 

Top edge 

Bottom edge 

Top border 

Bottom border 

Left border 

Right border 


First Key 
Next Key 
End 
First Key 
End 
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Next key moves within screen to... 
Left edge of screen 

Right edge 

Top edge 

Bottom edge 


Next key moves within window to... 


Middle of window 
Middle of window 


Next key moves on the line to... 


Beginning of line 
End of line 


Next key simulates mouse click... 
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3.2.2.5 Mouse Sensitive Points 


There are several mouse-sensitive points on the screen where the mouse can be used to 
directly: move, stretch, or contract a window; start and extend the text selection; make a 
window the active window; top or bottom a window; and scroll the window vertically or 
horizontally. 


In the following table, the left column shows the command name, the middle column 
shows the location of the mouse cursor, and the right column shows the mouse button to 


press. means (il Mi) on a two-button mouse. 


Command Cursor Position Mouse Button 
--Not Defined-- Outside window 
--Not Defined-- Outside window 
Display TOPLIST menu Outside window 
Select text (characters) Inside window 
Extend selection Inside window 
Display TOPLIST menu Inside window 
Scroll up Left border 
Scroll down Left border 
Thumb vertically Left border 
Scroll left Bottom border 
Scroll right Bottom border 
Thumb horizontally Bottom border 
Make active window Top border 
Move window Top border 
Split vertically Top border 
--Not Defined-- Right border 
--Not Defined-- Right border 
Split horizontally Right border 
Top/Bottom window — Any corner 
Stretch window Any corner 
--Not Defined-- Any corner 


Initialization Files 
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Initialization Files 


4.1 What They Do 


Initialization files use the .INI extension are to be called in the current session. They also 
define the menus you see on the screen. 


You can change top line commands and menus. You can also have several different top 
lines. You can even move the top line to the bottom of the screen. 


By customizing the .INI files, you can also specify pop-up mouse menus available inside 


any window. A combination determines which menu is invoked. You 
can also specify the names and commands on pop-up mouse menus. 


You can specify which mouse buttons invoke the select, extend, copy, and move 
functions. You can also specify options, and bind commands to keyboard keys. 
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4.2 How They Work 


When POINT loads, it looks for the PT.INI file and incorporates the command and menu 
definitions defined there. INI files are user-definable. 


After POINT finds and processes PT.INI, it checks the current directory for an additional 
file named PTLOCAL.INI. If it finds this file it processes it also. Since PTLOCAL.INI 
is processed after PT.INI, it can override the commands in PT.INI. 


The global PT.INI sets the options, menus, keys, etc. the way you usually want them. 
PTLOCAL.INI can further change the way POINT behaves in a given directory. 


PT.INI 


PTLOCAL.INI 


COLOR.INI 


MONO.INI 


PTEXPERT.INI 


PTM2.INI 


4.2.1 The PT.INI File 


The primary initialization file. Contains menu definitions, 
options and key bindings. 


4.2.2 PTLOCAL.INI Files 


An initialization file with functions you can define to work in 
a specific sub-directory. 


4.2.3 Other INI files 


The color file. If you have a color monitor, copy COLOR. INI 
to PT.INI. 


The monochrome file, this file as well as the original P'!.INI 
is set up for monochrome monitors (also for black and white 
monitors running with the color card). 


If you have been using a color monitor and must now use a 
monochrome monitor, copy this file back into PT.INI. This 
file is a replica of the original PT.INI file. 


The expert file. Copy this file into PT.INI when you are more 
familiar with the POINT Editor. 


Integrates the POINT editor with the programming 
environment for LOGITECH Modula-2, Version 3.0. 
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4.3 Options 


The following options can be included as is in your PT.INI file. 


For these options the default is always listed first. The capitalization of the option names 
is done for clarity in processing the PT.INI file capitalization is ignored. 


43lines=0 
The screen shows the usual 25 lines of text. 


43lines=1 
You have the Enhanced Graphics Adapter and a monochrome display or the 
Enhanced Graphics Display. If 431ines=1, POINT uses the smaller (8x8) 
character set which allows 43 lines on the screen (still with 80 characters per 
line). 


autoiIndent=1 


When a newline ((_.1 } key) is inserted, also insert the spaces and tabs that 
begin the previous line. 


autoIndent=0 
No special action on inserting a newline. 


buffers=50 
The number of 1024-byte memory buffers are allocated to hold parts of the files 
being edited. As you specify more buffers, POINT will work faster for larger 
files but it will also use up more space in memory. The value of "buffers" must 
be in the range of 2 to 300. 


cursorMouse=0 
When the mouse driver is present in memory, the cursor motion keys will 
actually move the selection. This is usually what you want but it is slower and 
does not really simulate mouse cursor motion. 


cursorMouse=1 
The cursor keys will only move the mouse cursor and will have no effect on the 
selection. This is much faster and provides complete mouse simulation but it 
means that you need an extra keystroke after cursor motion to make the 
selection. This is the default if the mouse driver is not present in memory. 


Chapter 4 


dosExit=C: \COMMAND.COM 
This controls which command processor is invoked when you execute the 
Execute DOS Command Processor command. Actually the default is the 
value of the COMSPEC variable. If you use some other command processor 
you can have that be invoked instead of COMMAND.COM. 


£ullNames=0 
Only the filename is shown on the window banner and the default Toplist Menu. 


fullNames=1 
The fuii pathname of the file is shown. 


filePattern=*. %* 
This is a DOS file name pattern with the wildcard character ‘*’ and ‘?’ allowed. 
It is used by POINT to determine which file names are displayed for mouse 
selection when you load a file into a window. The pattern can contain a PATH 
name. For example, filePattern;=\wp\%.doc is a valid filePattern. 


You can specify several file patterns separated with a vertical bar (|). POINT 
will display all matching file names. For example, 
filePattern=* .txt | \etc\%*.dat |**.prg is a valid filePattern. 


helpMode=2 
Whenever a top line or menu command is touched, a short, one-line description 
of the command is written on the bottom line of the display. 


helpMode=1 
Whenever a menu command is touched, a short, one-line description of the 
command is written on the bottom line of the display. 


helpMode=0 
No description messages are displayed. 


ignoreCase=0 
Search and Replace commands — consider case in the string being searched. 
No match is made unless the characters and the cases both are equal. 


ignoreCase=1 
Search and Replace commands — ignore case in the string searched. 


ignoreCase=2 
Searches strings with upper case letters are case sensitive; others are insensitive. 
Applies to Search for String, not tO Search for Selection. 
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initialWindows=0 
Each file listed on the command line is put in a full screen window and the 
windows overlay each other. 


initialWindows=1 
The first window takes up the whole screen, the rest of the windows are evenly 
spaced horizontally down the screen and are all the whole width of the screen. 


initialWindows=2 
The first window takes up the whole screen. The rest of the windows are evenly 
spaced vertically across the screen and are all the whole length of the screen. 


linesOverFind=0..4 
linesOverFind=0 determines placement in the window of a search string 
when it is found by a search command. If the window must be scrolled 
vertically, linesOverFind determines how many lines from top of the screen 
the found string will be placed. If the value of linesOverFind would place 
the string below the bottom of the window, the search string is placed in the 
middle of he window. The default value is LinesOverFind=4, 


makeBaks=1 


Make .BAK backup files when a file is edited and saved. 


makeBaks=0 


Do not make .BAK files. 


noRecurse=0 
Do not complain if a second copy of POINT is started. 


noRecurse=1 
If POINT finds an existing POINT work file in the current directory, it assumes 
that a copy of POINT is already running and issues a warning message to that 
effect. This warning message is often caused by an old POINT work file that 
was not deleted because the system was turned off while POINT was running. 


overType=0 
Insert characters that are typed. 


overType=1 
Typed characters replace screen characters, except for the end-of-line character. 


readOnly=0 
Files can be written back to disk using the same file name. 


readOnly=1 
Files cannot be written back to disk using the same file name. 
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rightBack=0 
scrolls up, and scrolls down. 
This has no effect on the meaning of and 


rightBack=1 
scrolls up (backwards in the file) and scrolls down. 


rightBack=2 


scrolls up, and the(Q_Q mi) scrolls down. Scrolling up with the mouse 


causes the line the mouse cursor is on to become the bottom line. 


rightBack=3 


scrolls up (backwards in the file) and scrolls down. Scrolling 
up with sends the mouse cursor line on to the bottom of the screen. 


rightMargin=999 
The right margin controls the word wrap feature of POINT. When you are 
typing in text and you pass the right margin, the word you are typing to moved 
to the next line automatically and a newline is inserted in front of it. A "word" 
is a sequence of characters delimited by blanks or tabs. 


searchMode=0 
String searches start at the selection (or the beginning of the file if the selection 
is not in the window) and go to the end of the file. 


searchMode=1 
Search from the selection backwards to the beginning of the file. 


searchMode=2 
Start search from the selection, go to the end of file, continue at the beginning of 
file, and go to the selection. searchMode=2 always succeeds, since it finds the 
original selection (after searching the whole file) even if the selection does not 
occur any other place in the file. 


searchMode=3 
Search for string in all the windows. Start at the active window and search the 
files in each window below it until the bottom window. POINT message issues 
telling you which file is being searched (although they go by more quickly than 
you can read them, unless you have very large or heavily edited files). 


When the string is found, all the windows on top of the window in which the 
string is found are bottomed. Another search will continue in this and the 
following windows. 
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tabWidth=8 
The tab stops are set every 8 places. Any value can be set. 


tiledSplit=0 
When a window is split it stays the same size, and the split window is half its 
size. 


tiledSplit=1 
When a window is split it is reduced to half its size, and the split window takes 
up the other half of the screen space it was using. 


topOnFind=0 
When a string is found in a window, the window is NOT automatically made the 
top window. This means that you may not be able to see the string that was 
found since it might be beneath another window. 


topOnFind=1 
When a string is found in a window, the window is automatically made the top 
window. 


undoBack=0 


Undo Last Edit records its action in the change history and can only undo 
one previous action. 


undoBack=1 
Undo Last Edit acts like Undo, Erase History. 


undoSize=50 
How many previous changes are remembered that can be undone. The value of 
undoSize must be in the range 2 to 100. 


unixMode=0 
Use MS DOS line ending convention for all files. This is the default value. 


unixMode=1 
Use UNIX line ending convention for all files. 


unixMode=2 
Use the convention that appears to be correct for each file. 


The POINT Editor examines the first 300 characters of each file as it is read. If 
any of these characters is a carriage return (decimal 15) it uses the DOS line 
ending convention for that file, otherwise it uses the UNIX convention. This 
decision is made once for a file and not changed until another file (or the same 
file) is loaded into the window. 
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videoMode=0 
For monochrome or EGA adapters. No synchronizing is done on screen 
updating. This is the fastest method. 


videoMode=1 The display is written using the BIOS calls. This mode is the slowest 
but it should work in the widest range of environments and machines. 


videoMode=2 
The display is written (two bytes at a time) during the horizontal retrace. This 
mode should not cause any flicker (or snow) on a color graphics display but it is 
slower than videoMode=0. 


videoMode=3 
The display is written (one byte at a time) during the horizontal retrace. This 
mode will not cause any flicker (or snow) on a color graphics display but it is 
slower than videoMode=2. 


workDrive=.\ 
The POINT work file will be put on this drive and directory. The default is the 
current drive and directory. You can use this to put the work drive on a RAM 
disk. The string can be a drive letter (and colon), a directory name, or a drive 
letter (and colon) and directory name. If you include a directory name, be sure 
to end it with a backslash ( \ ). 
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4.3.1 Color Options 


These options set foreground and background colors for various parts of the screen. For 
monochrome displays, they set video attributes for the characters: 


normal video, 
reverse video, 
underlined, 
blinking, 
intense. 


Each option consists of several pairs of hexadecimal digits. In each pair the first digit is 
the background color and the second digit is the foreground color. 


The color code is defined by IBM PC hardware. The hex color codes are: 


Code Color Code Color 
0 Black 8 Grey 
1 Blue 9 Light Blue 
2 Green A Light Green 
3 Cyan B Light Cyan 
4 Red Cc Light Red 
5 Magenta D Light Magenta 
6 Brown E Yellow 
7 White F Bright White 


Only the first eight color codes (0-7) are supported for background colors. Using any of 
the other eight color codes (8-F) will cause the character to blink. It is possible to 
reprogram the display hardware so that color codes 8-F cause bright backgrounds rather 
than blinking characters. You can do this reprogramming from the interactive color 
setting screen (described below). 
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textColors=0770 


The first pair is the color of ordinary text and the second pair is the color of 
selected text. Each window can use different textColors. 


borderColors=70070F 
The first pair is the color of banner/menu line of the top of the window. 
The second pair is the coior of the ieft, right, and bottom borders. 


The third pair is the color of the elevator on the left border. Each window can 
use different borderColors. 


msgColors=070FF070 
The first pair is the color of informational messages. 


The second pair is the color of user input to the prompt, parts of the new/load 
file selection screen, and a few error messages. 


The third pair is the color of error messages. 


The fourth pair is the color of the top line containing commands and menus (if 
you have one). . 
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4.4 Command Codes 


Always specify commands in .INI files by their numbers. 


4.4.1 Code and Associated Functions 


Here are numbers and their associated POINT commands: 


Number 


— = 1 
“QD DOAN OA AON =| OC 


oe ree ee ee ee eee Ce 
OMAN DUO f DDD 


NNN N ND ND 
ah QHD =| © 


Command 


No action. 

No action. 

Enter a character. (Do not use.) 
Duplicate. Enter or exit duplicate mode. 
Extract. Enter or exit extract mode. 
Delete the selection to the scrap. 
Quit and ask about edited files. 

Set the value of the "debug" variable. 
Create a new window. 

Jump to the beginning of the file. 
Jump to the end of the file. 

Redraw the screen. 

Zoom the window. 

Top the window. 

Change the size of the window. 
Scroll up. 

Scroll down. 

Jump to a line number. 

Close window. | 

Write the file to a new name. 
Search for a string. 

Global replace. 

Display debugging information. 
Cancel duplicate and extract modes. 
Insert ASCII character. 

Redo. 

Undo (reversible). 
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Number Command 


26 Select text. 

27 Search for the selection. 

28  Top/Bottom the window. 

29 Bottom the window. 

30 Execute the selection. 

31 Do nothing. 

32 Execute the DOS command interpreter. 
33 Load a new file into the window. 
34 Move the cursor up. 

35 Move the cursor down. 

36 Move the cursor left. 

37 Move the cursor right. 

38 Hide the window. 

39 Extend the selection. 

40 Undo (multiple). 

41 Simulate mouse buttons. 

42 Fast cursor movements. 

43. Jumps to the edges and borders of the window. 
44 Jumps to the edges of the screen. 
45 First Mouse Motion Command. 

46 Second Mouse Motion Command. 
47 Save all unsaved files. 

48 Quit and save all edited files. 

49 Quit and discard all edits. 

50 Invoke user menu i. 

51 Invoke user menu 2. 

52 Invoke user menu 3. 

53 TOPLIST menu (the file in each window). 
54 Save the file in the window. 

55 Insert from scrap. 

56 Go back to the last place you were. 
57 = Copy to scrap. 

58 Show the selection. 

59 Toggle insert/overtype mode. 

60 Invoke user menu 4. 


Number 
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Command 


Delete, not to scrap. 

Exchange the selection with the scrap. 

OPTIONS menu. 

Invoke the help system. 

Invoke user menu 5. 

Search in the reverse direction. 

Invoke user menu 6. 

Toggle 43-line mode (for EGA only). 

Copy the selection to this spot. 

Move the selection to this spot. 

Change the menu (do not use). 

Close and automatically save the file. 

Load the selected file name into active window. 

Move cursor one word (blank delimited) left. 

Move cursor one word (blank delimited) right. 
Begin/end recording keystrokes in macro buffer. 

Play back keystrokes from macro buffer. 

Move Window and selection to the beginning of the file. 
User-defined menu seven. 

User-defined menu eight. 

Change case (Upper/lower) of the first character of the selection. 
Create a window and load the selected file name. 

Find matching bracket: ( or ), [ or ], or { or }. 

Go to the selected line number. 

Justify all the lines selected between Left Border and Right Margin 
Toggle Read-Only Status. 

Change the Color Combination. 

Exchange the two top windows. 
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4.4.2 Functions and Associated Code 


Number Command 


Window 7 New Window 
Management 82 New Window From Selection 
38 Hide Window 
17 Close Window 
72 Close Window And Save File 
— Split Window 
10 Redraw Screen 
Position Window 12 Top Window 
29 Bottom Window 
28 Top/Bottom Window 
11 Zoom Window 
13 Change Window Size 
— Stretch Window From A Corner 
— Move Window 
Position File 15 Scroll Down 
in Window 14 Scroll Up 
— Scroll Left 
— Scroll Right 
Thumb Vertical 
— Thumb Horizontal 
19 Search For String 
27 Search For Selected String : 
66 Search Backwards For Selected String 
20 Replace String 
8 Go To Beginning Of File 
9 Go To End Of File 
16 Go To Line Number 
84 Go To Selected Line Number 
56 Go Back To Last Place 
58 Go To And Show Selection 
83 Finding Matching Bracket 
78 Beginning of the File and Move Selection 
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Number Command 


File Commands 33 Load A New File Into Active Window 
73 Load Selected File Name Into Active Window 
54 Save File In Window 
46 Save All Unsaved Files 
18 Save File In Window Using Another Name 
Select Text 26 Select Text 
39 Extend Selection 
Insert Characters — Insert Character 
23 Insert ASCII Character 
Copy And 69 Copy Text 
Move Text 2 Duplicate Text 
70 Move Text 
3 Extract Text 
4 Delete Selection to the Scrap Buffer 
61 Delete Selection but Preserve the Scrap Buffer 
57 Copy Text To Scrap Buffer 
55 Insert Text From Scrap Buffer 
62 Exchange Selection with Scrap Buffer 
22 Cancel 
59 Toggle Insert/Overtype Mode 
Redo And 24 Redo Last Edit 
Undo Edits 25 Undo Last Edit (Reversible) 
40 Undo Edit (Multiple Step Undo) 
Quit Commands 5 Quit And Ask About Unsaved Files 
48 Quit And Save All Unsaved Files 
49 Quit And Discard All Edits 
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Execute 
DOS Commands 


Macro Commands 


Miscellaneous 
Commands 


Invoke 
Menu Commands 


Keyboard 
Cursor Movement 
Commands 


51 


35 


Command 


Execute Selection and put Output in a Window 
Escape to a DOS Command Interpreter 


Begin/End Recording Keystrokes 
Play Back Recorded Keystrokes 


Set Value of the "debug" Variable 
Display POINT Information 
Invoke Help System 

Toggle 43-line mode (EGA) 


Invoke User Menu 1 
Invoke User Menu 2 
Invoke User Menu 3 
Invoke User Menu 4 
Invoke User Menu 5 
Invoke User Menu 6 
Invoke User Menu 7 
Invoke User Menu 8 
Invoke TOPLIST Menu 
Invoke OPTIONS Menu 


Move Cursor Up 

Move Cursor Down 

Move Cursor Left 

Move Cursor Right 

Fast Cursor Movement 

Move Cursor to the Edges of the Window 

Move Cursor to the Edges of the Screen 

Simulate Mouse Buttons 

Move Cursor One Word (Blank Delimited) Left 
Move Cursor One Word (Blank Delimited) Right 
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4.5 Menu Commands 


All menus (top line, bottom line, and pop-up menus) are specified the same way. You 
can define up to eight menus. Menus are numbered 1 to 8 and their command numbers 
are: 


Menu # Command # 


50 
51 
52 
60 
65 
67 
79 
80 


Ona ah OD 


A menu specification starts with 


[ an open bracket 
followed by the menu number 
N (where N is a number in the range 1 — 8) 


followed by one or more menu items, and 


] a close bracket 


A menu item is specified as a string in double quotes ("" ), an equal sign (=), anda 
command number: 


"<Command Name>"=<commandNumber> 


"Command Name", or whatever title you choose is what you want to see in the menu on 
the screen. It can have spaces within the quotation marks, but not around the "=" or 
within <commandNumber>. It can use any of the 256 characters in the IBM PC extended 
character set. 


<commandNumber> is the POINT command number as listed above. 


A menu can contain up to 24 items (that’s all that will fit on the screen). The "Command 
Name" can be as long or short as you want although there is a limit of 1400 characters for 
all names in all menus. 
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The first menu item is treated differently from the rest. The "command name" of the first 
item is taken to be the title of the menu. If you don’t want a title, you can use an empty 
string (""). Top line menus do not use titles, so their title should be empty. 
Remember, though — the first item is the title item, even for top line menus. 


The command number of the title item is the command for the menu. This is the 
command that will be executed if you do not select any menu item. Normally this is 
called the null command. Use a command number of -1 or 0 for the null command. 


See the .INI files on your POINT diskette for examples of menu specifications. 


NOTE 


Do not include angle brackets < or > or spaces in the string, or around 
the = sign. Strings like the above must be separated from other strings of the 


same type by one or more blanks, tabs, or new lines. 


4.5.1 Top Line Menus 


To specify a top line menu (as defined above), include a line in PT.INI with this format: 


tXY=<commandNumber> 


where "<commandNumber>" is (as before) a POINT command number. 
To specify a menu, use one of the menu command numbers: 50, 51, 52, 60, 65, or 67. 
You can use either an upper case "T" or a lower case "t". 


"Xx" tells whether you want to alter the state of the that calls this menu. 
"X" is a digit from 0 - 7 which isa shift key code. The codes are: 


X Code Shift state specified 


: , and( Alt )keys are all up 
down 
down 
down 
down 
TShitt down 
down 
down 


NO of © DD + © 
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"y" is the state of the mouse button keys you require to be down to invoke this menu. 
"y" is also a digit from oO - 7. 


Y Code Button state specified 


SSESEEE 


7 
The menu is invoked if the matches the "xx" you specify. To have 
several different combinations, include several tXY=<commandNumber> lines in PT.INI 
with the same <commandNumber>, one for each combination. 


You can specify several different menus as top line menus. The one with the lowest 
hexadecimal "xy" number is the default menu, and is displayed first. 


If you move the mouse cursor to the top line and press a button, the appropriate menu for 
that(_? }{Q OQ) will appear. No action takes place until you release the button. You 
can change buttons while on the top line to look at the menus available. If you move the 
mouse cursor from the top line before releasing the buttons, the default command of the 
menu will be executed. It is safest to make this a "do nothing" command. If you have 
only one top line menu, the menus and commands on it will be executed when you press 
the correct mouse button on the top line. 


For example, the following line in PT.INI uses manu 1 as the top line menu. (Command 
number 50 is menu 1). 


t01=50 


If you specify a non-menu command number as a top line menu number, then that 
command will be executed when POINT detects the specified at the top 
line of the screen. Thus, you can program certain commands to be invoked at the click of 
a mouse button on the top line. For example, to invoke New Window whenever you click 
on the top line, specify: 


t02=7 
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4.5.2 Pop-up Menus 


You can also tell a menu to pop up whenever you press certain (00 0} 
combinations, either inside or outside a window. Specify a pop-up menu as follows: 


bXY=commandNumber 


where "XY" and "commandNumber" are as described in top line menus above. Top line 
menus are called when the correct combination is seen while the mouse 
cursor is on the top line of the screen. These pop-up menus are invoked when the correct 


{C1 Q) combination is seen and the mouse cursor is inside any window or 
outside all windows. 


For example, look at the following lines in PT.INI: 


b01=50 menu 1 (command #50) to pop up when you press 
b02=51 menu 2 to pop up when you press , and 
b03=52 menu 3 to pop up when you press 

(or (1B) on a2-button mouse). 


4.5.3 Bottom Line Menus 


You can also place your "top line" on the bottom of the screen, if you wish. Specify 
bottom line menus in exactly the same way as top line menus only use "1" or "L" instead 
of "t" or "t" as follows: 


LXY=<commandNumber> 
Everything else is the same as top line menus. 


You cannot mix top line and bottom line menus. The menu that POINT sees first 
prevails. You will get error messages on menus that are not of the same type (either top 
or bottom), and they will be changed to the first type encountered. 
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4.6 Mouse Motion Commands 


4.6.1 First Mouse Motion Command 


The command number for mouse motion is 45. 
does this with the following line in PT.INI: 
b04=45 


If you use a two button mouse, attach mouse motion to with the line: 
b02=45 


If you attach the mouse motion command to , change the NO MOTION 
subcommand to extend so as not to lose the ability to extend the selection with the 
mouse. Then will act almost as it did before except you will be able to issue 
mouse commands with it also. What you will lose is the ability to drag the selection 
when extending it (that is, pressing and moving it to adjust the selection). It is 
not usual to do this anyway so the actual loss of function is small and the gain of having 
eight other mouse motion commands immediately available with is great. 
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4.6.2 First Mouse Motion Subcommands 
Subcommands can be changed in PT.INI with lines of the form: 


=commandNumber 


where N is in a range from 0 to 8 as in the chart below: 


N(1) 
NW[8] | NE[2) 
St 
\ | / 
W[7] <---- [0] ----> E[3] 


| 
SW[6] | SE[4] 


$[5] 


To change the no motion action to extend use: 


m0=39 — 39 is the extend selection command 


Here are some other change ideas: 


m3=29 — Right motion bottoms the window 
m7=57 — Left motion copies the selection to the scrap 


4.6.3 Second Mouse Motion Command 


[Command #46] 


Default subcommands of the second mouse motion command are: 


move to 
last place 


close delete- 


| 
window | no scrap 
| 


\ | / 
copy to <--- extend ---> exchange 
scrap / IN with scrap 

/ \ 
/ \ 

bottom cancel 

window 

TOPLIST 


The command numbers are: 


extend #39 

move to last place #56 
delete/no scrap #61 
exchange with scrap #62 
cancel #22 

TOPLIST — #53 

bottom #29 

copy to scrap #57 

close window #17 
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The second mouse motion commands can be changed in PT.INI with lines of the form: 


nN=commandNumber 


where N is 0, 1, 2, 3, 4, 5, 6, 7, or 8 as in the chart above. 
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4.6.4 Other Mouse Motion Parameters 
You can also adjust POINT parameters to decide mouse motion direction. 


Parameter 1 chooses between north and northeast. Parameter 3 chooses between 
northeast and east. We will talk about parameter 2 later. These parameters are the ratio 
of the number of rows you moved north and the number of columns you moved east 
multiplied by 100 so that they are integers. The default values are 175 and 25. 


Set these values in PT.INI. The default values are: 
qi=175 
q3=25 


Experiment with these values if the defaults do not seem natural to you. These same 
parameters are used for the four other quadrants of the plane. 


If you specify the diagonal commands to be -1 or 31 (no action), POINT uses the nearest 
vertical or horizontal command. This can be used to reduce the possible motions to just 
four: north, east, west, south and no motion. Parameter 2 is used in this case to decode 
between north and east. The default value is 45 which is about a 45 degree angle. (That 
they are both 45 is a coincidence.) 
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4.7 Mouse Sensitive Window Points 


You can decide (via lines in PT.INI) what command is executed when certain mouse 
buttons are clicked on parts of a window. Those you can change are listed below with 
the string used to set them in PT.INI enclosed in [square brackets]. 


[wtlm] or top left corner 
[well] top left corner 
[wtrm] or top right corner 
[wtrl] top right corner 
[wblm] or bottom left corner 
[wbll] bottom left corner 
[wbrm] or bottom right corner 
[wbrl] bottom right corner 
[wrb]] right border 

[wrbr] right border 


Set these commands with lines in PT.INI of the form: 


wtlm=88 (exchange the top two windows) 
wtrm=88 

wblm=88 

wbrm=88 

wt11=28 (top/bottom the window) 
wtrl=28 

wb11=28 

wbr1=28 

wrbl=27 (search for selection) 

wrbr=66 (search backwards for the selection) 


These lines also indicate default commands: on any corner swaps the two top 
windows, on the right border searches up for the selection and on the 


right border searches down for the selection. 


You may want to let on the top left corner be the Beginning of File and Move 
Selection command (see Section 3.2). 
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4.8 Mouse Button Commands 


The method described in the previous section can be used to assign any command (not 


just a menu) to a combination. This is most often used to assign the 


select, extend, copy, and move functions to mouse buttons inside windows. 


For example, the lines below assign select to , extend to , copy to 
TShift Hm! QQ), and move to ‘m2aQ). 


b01=26 select 
b02=39 extend 
b11=69 copy selection to here 
b21=70 CtrlHm QQ) ~~ move selection to here 


The .INI files on your disk contain examples of defined menus and functions assigned to 
top line menus and pop-up menus. They also suggest ways to effectively use these menu 
definition facilities. Start by using these .INI files, and modify them as you gain 
experience. 
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4.9 Key Commands 


You can assign POINT commands to any key. However, the standard DOS keyboard 


handler does not let you reset certain key combinations (e.g., and ). 
In addition, certain keys are intercepted by DOS before the POINT Editor sees them. 


Define keys with a line in PT.INI of the form: 
kN=<commandNumber> 


Either "k" or "K" tells POINT that a key is about to be defined, N specifies the key being 
defined, and <commandNumber> is a POINT command number as defined above. To 
define an ASCII code, let N be the ASCH character, specified as a decimal number. 
Use any ASCII chart (as in Appendix G of the IBM PC BASIC Manual) to find the 
character codes. We include one here also. 


To define one of the other keys on the PC keyboard (such as : , etc.) 
start N with the zero (0) digit and then the extended code number of that key. We also 
list them here for your convenience. The initial "0" required in N is included so that the 
POINT Editor will know this is an extended key code and not an ASCIT character. 


A table of extended code numbers is in Appendix G of the IBM PC BASIC Manual. 


Let’s look at some sample lines that might appear in PT.INI. These lines redefine three 
keys. 


k059=7 calls New Window 
k14=7 [N} calls New Window 
k082=59 (Ins) toggles between overtype and insert modes 


The following tables shows command functions that can be attached to keys as defined in 
the PT.INI file. 


The format for this definition is 
k<N>=<Command Number> 


where 
k or K indicates that a key is about to be defined, 
<N> is one of the key codes defined in Section B.1, and 
<Command Number> is a number defined in Section B.2. 
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ASCII 
Code 


Character ASCII Character 


BSOMIANDANAWNH OS 


11 44 
12 45 : 
13 46 


—OOYNNMNPWNK O™ 


Q@~r~vi A-- 
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ASCII Character ASCII Character 


A 
B 
Cc 
D 
E 
F 
G 
H 
I 
J 
K 
L 
M 
N 
O 
P 
Q 
R 
S 
T 
U 
V 
WwW 
X 
bg 
Z 
[ 
\ 
] 
A 


lL ~wmHONS KES Grn ovdeos Beno TH Mmeac Ts 
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Extended Code Characters 


003 NUL 

015 
016-025 plus (Q) (E) 

030-038 (At) »weASOOGWYWhH) 
044-050 (Alt) plus (Z) (X) (C) (N) (m4) 


059-068 aes through (F10) (unshifted) 


‘v71 


dj 


071 {Home} 
072 
073 
075 
077 
079 
080 
081 
082 
083 
084 - 093 through [fShift}{F10 
094 - 0103 Ctrl through [Ctri}HF10 
0104 - 0113 through (Alt }{F10 
0114 Ctrl H{PrtSc 
0115 
Vllo = (Ctri{3) 
0117 
0118 Ctrl Eabr) 
0119 
0120 - 0131 GH nis) DOGOOO@OOAG 
0132 rlHPgUp) 


How POINT is Displayed 


Chapter 5 


How POINT is Displayed 


This chapter describes how text appears, screen layout, how windows appear, how text is 
handled in the windows, how files are managed, and a general overview of POINT 


commands. 


Remember: there are three primary functions on your POINT screen: 


Selection cursor 


Selection 


Insertion point 


A blinking square that can be moved by the mouse — or, if 
you have no mouse, by keypad cursor keys — to either select 
a new insertion point, or so select a command outside the text 
window. The new selection or command is then implemented 


with (and sometimes also with ). 


An area of text that is highlighted for purposes of 
manipulation, or for indicating the insertion point. 


The area at the beginning of the selection at which new 
characters appear from your keyboard, or as the result of a 
move or copy operation from another area of text (from the 
same window, or even from a different file in another 
window). 


One last word here: the insertion point is set either to add 
characters at the insertion point (OverType=0) or to replace 
existing text with new text (OverType=1), 
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5.1 The POINT Screen on your Monitor 


5.1.1 The Main Screen 


5.1.1.1 The Top Line 
The top line of the screen contains command names and selected menus. 
To select a top line command, click the (ml Q Q)on the command name. 


To select a menu option, move the mouse cursor to the menu line and press and hold the 
on amenu name. This pulls down the menu. Then drag the highlighted cursor 
into the menu and release the button on the desired option. 


5.1.1.2 The Working Area 


The main body of the screen is the work area, where files are loaded and edited. 


5.1.1.3 The Bottom Line 


The bottom line of the screen initially displays the version and copyright notice. When 
editing begins and a menu command in invoked the bottom line becomes a comment line. 
The comment line, which alternates between simple help reminders and command 
prompts, is activated when the cursor is moved to the menu line. Move the blinking 
cursor to the menu line. Notice how the copyright notice temporarily becomes a 
comment. 


D - 82 


How POINT is Displayed 


5.1.2 The Selection Screen 


When you select open or New Window from the top line of the main screen, a 
selection screen displays the file names in the current working directory. 


5.1.2.1 Top Area 


There are three lines at the top area of the selection screen. Line one displays the 
directory Patterns the files are sorted by and the Number of files in the current 
directory. Line two displays command options you may invoke with the cursor. 
Line three displays user information. 


5.1.2.2 Work Area 


The work area displays a list of file names in the current directory. 


5.1.2.3 Bottom Line 


The bottom line prompts for a file name to load the new window. 


5.1.3 The Color Option Screen 


The color option screen is invoked from the Options menu by selecting one of three 
color options. The color option screen is a simple way to modify the color scheme of the 
active window. If you choose colors from the OPTIONS menu, you are shown a screen 
consisting of three major parts. 


The Top Area is a menu line with 10 commands. Nine of these are used to select the part 
of the display that you want to change the color of. The part that will be changed is 
selected by clicking on its name on this menu line. The tenth command exits interactive 
color setting. 


The Work Area is a line with four commands and a menu of the 128 possible 
combinations of foreground and background colors. Select a color combination by 
clicking on it. These commands let you look at another 128 color combinations (the 
alternate colors) which will either be blinking or have high-intensity background colors. 
Two commands switch you between plain and alternate color sets. The other two 
commands alternate the color set from regular to blinking to intense. 


The Bottom Area is a sample window that shows you the effect of the changes you have 
just made on the color options screen. 
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5.2 The Window on your POINT Screen 


5.2.1 The Banner Line 
The banner line at the top of each window displays: 


SAVE when editing space is low. 

Name of the file loaded in the window. 

* if the file has been changed. 

Line numbers shown in the window. 

Column numbers shown in the window. 

OverType when POINT Editor is in overtype mode. 
Unused space filled with blanks or double bars. 


5.2.1.1 The SAVE Message 


The POINT Editor uses an “edit space" to keep track of changes: the space available here 
for editing depends not on file size, but rather on the number of changes you make in the 
files, 


When editing space is low, SAVE appears in front of the file name in each window. 
When this happens, save one or more edited files to reclaim the editing space. 


5.2.1.2 The File Name 


The file name displayed is exactly as you typed it (including capitalization) and may 
include a PATH name. If the file in the window has been changed, a * (asterisk) 
appears after the file name. 


5.2.1.3 Line and Column Numbers 


Line numbers and column numbers are given as arange. Column numbers can be useful 
when scrolling horizontally. 
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5.2.1.4 The OverType Message 


OverType shows in the banner line if keystrokes replace existing text. 


5.2.1.5 The Banner Line Fill Character 


The unused part of the banner line is blank, unless it is the active window. In the active 
window the double line goes through the unused part of the banner line. 


5.2.1.6 Banner Line Mouse Commands 


If you press on the window banner line, a shadow border follows the mouse 
cursor and lets you move the window anywhere on the screen. The window gets smaller 
if you run into the edge of the screen, but grows back again as you move away from the 
edge. 


on a banner makes its window active. 
on a banner splits the window. 
on a banner can drag the window to a new area on the screen. 
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§.2.2 The Border 


The active window has a double line border. 
All other windows have a single line border. 


on the right window border splits the window. 
or on the bottom window border scrolls thumbs 


horizontally. 
(m9 00) (QQ) or (Q0 m) on the left window border scrolls or thumbs vertically. 


5.2.3 The Elevator 


The left border of the window has an "elevator" that indicates both the position of the 
window in the file and the amount of the file shown in the window. The left border 
between the two corners represents the whole document. 


The top and bottom of the elevator represent the top and bottom of your file. The further 
text is into the file, the further down the left border the elevator starts. The more of the 
elevator is in the left border, the more of the file is visible in the window (hence the 
shorter the file). As you scroll through the file, the highlighted portion of the left border 
moves up or down the left border. 


5.2.4 The Corners 
Each window corner has two commands that are invoked with either or 


. On that corner. 


on acorner tops the window, unless it is already the top window, in which case 
it bottoms the window. 


on a corner lets you stretch that corner by dragging it. An elastic shadow border 
follows the mouse cursor and the window assumes the size of the shadow border when 


you release the ; 


The comers are functionally separate from the banner line or any of the border lines. 
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5.3 The Text in your POINT Window 


5.3.1 Displayed Text 


Text in the window is a representation of the contents of the file in your window and is 
displayed as it would be on a printer. In most text files, lines end with a CR-LF 
(Carriage-Return, Line-Feed) sequence (ASCII 13 and 10). This sequence serves to 
position text that follows the CR-LF at column 1 on the next line in the window. 


5.3.2 Displayed Characters 


Characters are displayed using the graphics symbols defined by the IBM PC for the 256 
possible character values, with these exceptions: 


e moves to the next tab stop and is not displayed as a tab character. 

e Line-feed (ASCII 10) shows as a blank, and positions following text onto the 
beginning of the next line. 

e Carriage Return (ASCII 13) immediately followed by a Line Feed is ignored. 
A Carriage Return not followed by a Line Feed is displayed normally. 


5.3.3 The End-of-line Character 


At the end of each line, POINT displays a vertical rectangular blank that represents the 
Carriage-Return/Line-Feed sequence. This blank is only visible if you include it ina 
selection. Line-Feed (ASCII 10) alone will ba accepted as an end-of-line character, but 
when you press , a Carriage Return/Line Feed is inserted there in the file, and is 
called the "end-of-line character." 
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5.3.4 Selected Text 


There is always a current selection (unless no windows are open). The selection is a 
sequence of one or more characters in one of the displayed files. It’s not necessary for 
the selection to be visible in a window (it might be in a window partly covered by 
another window). 


Selection specifies the text that you want to manipulate. After selecting, you generally 
issue a command that affects the selection. 


Selection has no effect except to change the appearance of the dispiay until you issue a 
command that affects the selection. So, making a selection does not imply any 
commitment to do anything. And, if you select the wrong item, simply make another 
selection before issuing a command. 


The OPTIONS menu has a textColors option which sets various color or video 
attributes of both the text in a window and of selected text. A contrasting color can help 
keep track of selected text for foolproof manipulation. 


5.3.4.1 Select Text 


To make characters in the document the current selection, do this: 


Press to start the selection. Hold down and move the mouse to select 


additional text. You can move either forward or backward from where you first pressed 


the (MOQ). 


The selection starts in character mode. If you release the and press it again 
inside the selection, you select word mode and the seiection is extended one word ai a 
time. A third press selects line mode, and the selection is extended one line at a time. A 
fourth click returns to character mode. Selection mode affects how copy and move act. 


[ #26, ( , inside window) ] 
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5.3.4.2 Select Words and Lines 
Click once for character mode. If you move the mouse while is still 


pressed, the cursor extends the selection character by character. 


If the mouse cursor is on a currently selected character and you press twice, you 
select the entire word. In this case the cursor extends the selection word by word. 


A third click inside the selection changes the selection to line mode, and the cursor 
extends the selection line by line. 


A fourth click cycles back to character mode. 


5.3.4.3 Extend the Selection 
extends or contracts the selection. To start, click to select. Then, 


move the mouse cursor to where you want the highlighted selection to end. Press 


and the selection will extend to that point. If you hold down , the 


highlighted selection will follow the mouse cursor just as it does when you select with 


You can move either forward or backward from the place you first pressed{Q OQ @). To 
extend a selection beyond the immediate text in the window, start with (ml QQ), move 
the window as needed, and extend the selection with 


Characters are added to (or removed from) the current selection. Press to start 
the extension. Hold the button down and move the mouse to select more or less text. 


[#39, mouse ( , inside window)] 


5.3.4.4 Select the End-of-line 


The end-of-line character is at the end of each line in the window. It appears as a blank 
on the screen, but can be distinguished from actual spaces in the text since it is always 
the last character on a selected line. Actually, Carriage-Return/New-Line (the 
combination) marks the end of a line in DOS formatted text. You can’t select either 
Carriage-Return or New-Line separately if they are together. 


A New-Line alone is an end-of-line character. In this case you can effectively select the 
New-Line alone. Carriage-Returns alone do display and can be selected. 


Deleting the end-of-line character joins that line with the next line. 
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5.3.4.5 Delete Text 


Selected text is deleted from the screen and saved in the scrap buffer for later insertion. 
The selection mode of the text in the scrap buffer is recorded. 


[#4, (Del) ,(F1)] 


5.3.4.6 Delete Text, Not to Scrap 


OR Rh tt oe Wem x eeren Lane etann a 
Seiecied text is deicied. The scrap buffer is not changed. 


[#61] 
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5.4 Input from your Keyboard to POINT 


5.4.1 Insert Text Characters 


5.4.1.1 The Insertion Point 


The insertion point is just before the first character of the selection. All characters typed 
on the keyboard are inserted here. First, select an insertion point in the text with the 
mouse cursor. Then click the . In this case, you are not selecting text to alter or 
manipulate; but rather a point at which you will enter new text. 


Most of the 128 ASCII characters are inserted by typing a corresponding key. 


Control characters are not inserted, but reserved by the operating system or interpreted 
specially by the editor. These include: 


(nul) 

(like (Ctrl}(Break) ) 

Ctrl or 

or (carriage return) 
or (escape) 
Ctrl}{P} , (suspend) 


If is pressed and autoIndent is set to 1, the next line is indented to the same level 
as the previous line. In fact, it will be indented with the same sequence of spaces and 
tabs that began the previous line. 


G 


If overType is set to 1, the next keystroke replaces the character after the insertion point. 


5.4.1.2 Insert and Overtype Modes 


You are initially in insert mode: any printable character you type appears at the insertion 
point. 


Switch to overtype (or overwrite, replace, or typeover) mode, from the OPTIONS menu 


or by pressing (O}. Now each new character types over existing text and replaces 
the next highlighted character. 


The banner line shows OverType to indicate that you are in overtype mode. 
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5.4.1.3 Backspace over Text 

erases the character previous to the selection. 
erases the previous word. 

A word to is either: 


e@ A sequence of letters (upper and lower case) and numbers 
@ A sequence of special characters (non-alphanumeric) 


The white space (spaces, tabs, and the end-of-line character) after the word is also 
deleted. 


begun in the middle of a word deletes only the characters before the 
selection. 


5.4.1.4 Insert ASCII Characters 


You can insert any extended ASCII character (the 256 characters defined for the IBM 
PC) into the text. Specify the character with its numerical ASCII value in either decimal, 
hexadecimal, or octal. 


If the leading two characters of the value you give are 0X the rest of the number is 
interpreted as hexadecimal. 


If the first character is 0 (and the second is not X), then the number is interpreted as 
octal, 


If neither is the case, the number is interpreted as decimal. 


[ #23, , EDITING menu ] 
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5.4.2 Enter a response 


5.4.2.1 Respond to a Prompt 


Sometimes a prompt appears on the bottom line of the display. Type text normally for a 


response. erases the last typed character, and erases everything 
on the line. You can’t select a response when the prompt is displayed, but can 
copy what is already selected into the response area. 


Conclude the response to a prompt with or , 
can be used to cancel an action that has requested input. 


Sometimes a default response appears. To accept this response, press or ; 
erases the last character of the default response and lets you edit the default 


response. Any other key erases the default response and starts a new response with the 
key you pressed. 


Some responses only need a yes or no answer and terminate after you type either | Y | or 
(N). For Yes/No questions, is Y and any other mouse button is N only if the 
mouse cursor is on the bottom line of the screen. Yes/No questions also have default 
responses (usually Y). 


§.4.2.2 Select a File Name 


When you load a new file into a window or create a new window, you are shown a list of 
file names. Select a name by clicking on it with the mouse. 


The top line shows information about the files displayed: 


The current directory. 

How file names are sorted. 

Name pattern for displayed file names. 
Number of files in the directory. 


If there’s not enough room to show all the file names, you see the message 
SOME FILE NAMES MISSING and only some of the file names from the file pattern. 


The second line of the display shows five commands that affect file name display. 
Cancel load cancels the load or window create. 


If the list of files doesn’t fit on one screen, review other file names by using Next page 
and Previous page. 
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Click on New pattern to specify a pattern used to display the list of files. 
To specify more than one pattern in the list, separate each pattern with a vertical bar 
character (1). A file pattern can include a drive letter anda PATH name. The file name 
by itself, or as the last component of the path specification, can include DOS wild card 
characters (* and 7). 


Here are some examples of file patterns: 


*.%* ~~ all files in the current directory 
*.DOC all files with the extension .DOC 
*.DOC |*.TXT all files with .DOC or . TXT extensions 
\BIN\A*.BAT  .BAT files in\BIN beginning with A 


\BIN\*.BAT |\TEST\*.BAT  .BAT files in\BIN and\TEST 


From this screen you can: 


@ Click on the file name you want to load, 
e@ Type ina file name directly, or 
e Click on a command name to change the display. 


5.4.2.3 Options 


OPTIONS lets you change many options interactively. If you select an option (except for 
a True/False option), you are asked for a new value. True/False options are toggled 
from true to false, or false to true. 


5.4.2.4 Set Screen Colors 


If you choose any of the color options, you are shown a screen that lets you temporarily 
change the color scheme for the active window. The choices you make are immediately 
reflected in the sample screen in the box at the bottom of the screen. For permanent 
changes you must change the color statements in PT.INI. 
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5.5 File Handling in POINT 


5.5.1 Files in Windows 


All windows show a file name on the banner. When the window is loaded, it displays the 
contents of the file. As the file is edited, the window shows the most current version, but 
the original file on disk is unchanged until you save the edited file. 


All new text in the window is kept temporarily in a work file called PTTEMP.XXX. 
This file is in the working drive and directory, but it can be reset with the workDrive 
option in PT.INI. 


You can put the work file on a RAM disk, but it won’t speed things up much unless you 
are editing a very large file or many different files. The reason is that POINT tries to 
keep all the active parts of the work file in its internal buffers anyway. With large files or 
with many files, it will not be able to do this. 


by itself, when prompted for a New Window file name, creates an empty scratch 
window with the name UnNamed.x. 


5.5.2 Backup Files 


When you save a file, the previous version is saved in a .BAK file which contains the 
version you first loaded, not the version before the last save. That is, even if you save the 
file two or more times during an editing session, when you quit POINT the .BAK file 
will contain the version of the file before you began your session. 


The makeBaks option determines whether .BAK files are generated at all. 


5.5.3 File Handles 


POINT has a number of files open at the same time; therefore it needs sufficient DOS 
file handles to be able to have many files in many windows. You can tell DOS how 
many file handles to allocate in the CONFIG.SYS file. We recommend that you specify 
at least 20 and preferable 30 file handles in CONFIG.SYS. 
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5.5.4 Feedback On Long Operations 


Replace and Write operations now provide feedback about their progress as they 
execute. The idea is that any operation that might take more than a few seconds will 
provide feedback on its progress. 


Replace tells you what percent of the operation has been completed so far. This is true 
of the replace with verify and the global replace. The percent feedback tells you how 
much of the file has been searched so far, not what percent of the replaces have been 
done. (It cannot know how many actual replaces are needed until the replace is 
completed.) 


Any file that writing command provides continuous feedback about what percentage of 
the operation has been completed. This applies to write, to same, and to all file writing 
resulting from quit commands. 


5.5.5 Read-Only Files 


There is now a facility for read-only files. One purpose of this is to correctly handle files 
that have read only permission in DOS. Another purpose is to allow you to edit files 
without the possibility of accidentally changing them. A file in a window can be made 
read-only in three ways. . 


@ Load a file marked by DOS as read-only into a window. 


@ Load a file into a window when the global "readOnly” option flag (a new option) is 
true. 


@ Use anew command that toggles the readOnly state of a file in a window. 


Toggle Read Only [command #86] changes the readOnly status of the file in the 
active window. It does not let you change the readOn1y status of a file marked read- 
only by DOS. 


You can edit a read-only file on screen only. The changed version cannot be saved. 
Trying to save a readOnly file will result in an error message. Trying to quit with a 
readOnly file that has been edited will generate an error message and give you a chance 
to cancel the quit (by pressing the key) or to proceed with the quit without saving 
the changes (by pressing any other key). 


You can write a readOnLly file to another filename. 
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POINT Commands 


6.1 Invoking POINT 


Here is the format for invoking the POINT Editor from the DOS command line: 
PT [/O] [/H] [/V] [FILE1 [FILE2 ...] ] 


/ 


/O 


/H 


/V 


/L 


/ slash or — hyphen precedes option letters. 
—H, —O, and —-V,or /H, /O,and / V designate options. 


Overlaid is the initial windows default, with each window full 
screen and overlaid. 


Horizontal split loads initial windows full-width, with the first 
screen full, the second a few lines down, etc. 


Vertical split is similar, except that initial windows are all full 
screen height and spaced vertically and evenly across the 
screen. 


POINT looks for a file in the current directory named 
PT.LAS, from which it can reconstruct the last editing 
session. (Of course, you will not be able to undo edits from 
the previous session.) 


D-97 


Chapter 6 


[FILE1 [FILE2 ...] J 
POINT creates a window for each file name on the command 
line. If the file name you specify contains wildcard characters 
(* or ? ) it will expand to contain all matching file names, as 
specified in the DOS manual. A maximum of 20 files is 
allowed. 


Several additional options relate to invoking POINT. 


initialWindows sets arrangement of the initial windows 
buffers sets buffer space and memory to be used. 
videoMode _ sets how the screen will be updated. 
workDrive tells where the work file will be placed. A RAM disk is 
useful here for large files. 
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6.2 Command Format 


The commands in this chapter are grouped by function type. 


At the end of each command description [square brackets] contain the ways to invoke the 
function. The following parameters are used within the brackets. 


#n 


( , position) 


Qo CHA 


<command> 


<MENU> 


A number (e.g., #7) gives the number which identifies the 
command to the top line, to a keystroke, to a mouse button, or 
to a menu. 


, followed by where the function is called, 
is in parenthesis. 
( , any corner), for example, means: 

press (lO Q)on any corner of a window. 


Keys and key combinations that invoke commands. 


Top line commands (e.g., find) show the command name 
from the top line. 


Menu commands (e.g., WINDOWS) show the menu name from 
the top line. 


Top line command and menu names are those used in the distributed files PT.INI and 
COLOR.INI. PTEXPERT.INI uses a different top line. 


6.2.1 Esc and Ctrl-Break 


(Esc] is a general escape. Most commands can be aborted with no action or change by 
hitting (Esc) when keyboard or mouse input is requested. only stops actions that 
use keyboard input (e.g., writing a file, searching for a text string). 


stops the current editor action. 
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6.3 Window Management Commands 


6.3.1 Create a New Window 


To create a new window, click on New Window from the WINDOWS menu. You 
are asked to specify any two opposite comers. Press (and hold) at one corner. 
The first corner can be any of the four corners of the new window position. An elastic 
window border will follow the mouse cursor. Release the button at the opposite corner. 
If you double-click at the first corner without moving the mouse, the opposite corner will 
be taken to be the lower right corner of the screen. 


Next, POINT asks for a file to be loaded into the window. Select the file from a menu of 
file names or type in the file name. aborts the action, and no window is created. 
creates a window for a file named UNNAMED.X, where X is an alphabetical 
character [A .. Z]. 


(#7, At {(N)] 


6.3.2 New Window From Selection 


This is exactly like the New Window command (above), except that the file to load into 
the new window is taken from the text you have selected. 


(#82, Alt HF10} ,(Ctri}{F10) ] 


6.3.3 Hide Window 


The window is no longer displayed but is still open. The window is then "hidden" and 
only shows up on a second list at the end of the TOPLIST menu. Selecting a hidden 
window from TOPLIST unhides it and makes it the top/active window. It will be the 
same size and in the same position as when it was last visible. 


[#38, 
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6.3.4 Close Window 


The window is removed from the screen. If this is the last window that shows the file, 
you are asked whether to save the edited version of the file or to discard the edits and 
leave the original file unchanged. The file is closed and the window is deleted. 


(#17, Alt HC) ] 


6.3.5 Close Window and Save File 


The window is removed from the display. If the file has been changed it is saved 
automatically (no verify is requested). The file is closed and the window is deleted. 
[#72] 


6.3.6 Split Window 


A window can be split (vertically or horizontally) into two independently scrolled 
windows on the same file. The original window is unchanged and the split window is on 
top of it. The split window starts where the split was made and goes to the right or lower 
border of the original window. The tiledSplit option causes the original window and 
the new window to each take up part the space occupied by the original window. 


[ ¢ , top or right border) | 


6.3.7 Change Color Combination in Window 


This command changes the text and border colors of the active window to the next color 
combination on the list in the textColors and borderColors option. After the last 
one is used, the command cycles back to the first one. The default color combinations is 
included in this cycle. 

[ # 87] 


D- 101 


Chapter 6 


6.3.8 Window Positioning 


6.3.8.1 Top Window 


The window is made the top window shown on the display. 
[#12] 


6.3.8.2 Bottom Window 


The window is made the bottom window. 


[#29, ] 


6.3.8.3 Top/Bottom Window 


The window is made the top window unless it is already the top window, in which case it 
is made the bottom window. 


[#28, ( , any corner) | 


6.3.8.4 Zoom Window 


The window is expanded to cover the entire screen, or if it is already zoomed, it is 
returned to its original position. 


(#11, , WINDOWS menu] 


6.3.8.5 Change Window Size 


Respecify the size and position of the window. Press (and hold) the at any 
comer. From there, an elastic window border (where the mouse cursor is the opposite 
corner) will follow the cursor. Release the button when the window is the desired size. 
If you double-click at the first corner, the opposite corner is taken to be the lower right 
corner of the display. 

[#13, WINDOWS menu] 
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6.3.8.6 Stretch Window 


Change the window size on the display. The corner you first pressed the mouse 
button on is moved to the mouse position where you release the button. An elastic 
window border will follow the mouse as it is moved. The size can be increased or 
decreased. The position of the opposite corner of the window is not changed. 


[ ( , any corner)] 


6.3.8.7 Move Window 


The window is moved on the display. With the mouse cursor on the banner line, press 
and hold the . A shadow border follows the mouse. Release the button when 
the window is at the desired position. The size of the window is not changed unless you 
release the button while the shadow border is smaller due to being moved against the side 
of the display. 

im , banner line) ] 


6.3.8.8 Exchanging The Top Two Windows 


This command exchanges the places of the top two windows. This is useful when you 
are changing between two windows frequently but you also have other windows open 
also. 

[ #88] 
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6.4 File Management Commands 


6.4.1 Load File 


Loads a file into a window. A menu of file names is displayed. Use to select a 
file name, or type in the name. cancels the load. by itself creates a 
New Window with a file named Unnamed.x. If the file you ask for does not exist, you are 
asked whether or not to create it. If you answer (N) , the file load is canceled. If 
autoCreate is 1, then the file is created automatically without verification. If the file 
currently in the window was changed and is not displayed in any other window, you are 
asked if you want to save the edited file. 


(#33, , WINDOWS menu ] 


6.4.2 Load File From Selection 


This is like the load command, except that the file name is taken from the selection. 


[#73, (Shift ] 


6.4.3 Save File 


Writes the edited version of the file, and releases the editing space. This action cannot be 
undone, but a .BAK file is generated with the old version of the file. If makeBaks is set 
to 0, no .BAK file will be created. You cannot undo changes if you have saved the file 
since the changes were made. 


(#54, , WINDOWS menu] 


6.4.4 Save All Unsaved Files 


All files that have been edited but not saved are saved as described in the save file 
command (above). 


[ #46] 


6.4.5 Write With New Name 


Writes edited version of a file to a new file. You are prompted for a new file name. This 
action cannot be undone. 


[ #18, , QUITSETC menu ] 
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6.4.6 Toggle Read-Only Status of File 


This command changes the read-only status of the file in the active window, that is, it 
changes it from read-only to read-write or from read-write to read-only. It does not let 
you change a file to read-write if the DOS file permissions are read-only. 


[ #86] 


6.4.7 Scroll Down 


Moves window toward the end of file. If the window contains N lines, it scrolls N-2 lines 
. If you do this with the mouse, the amount scrolled depends on how where the mouse 
cursor is on the left window border. More precisely, the text line next to the mouse 
cursor becomes the top line of the window. If the mouse cursor is on line J in the 
window, the window scrolls one line. The rightBack option reverses the scroll 
direction of the mouse button. 


[ #15,(PgDn) , ( , left border) | 


6.4.8 Scroll Up 


Moves window toward the top of the file. The window is scrolled N-2 lines if the 
window contains N lines. If you invoke this with the mouse, the amount scrolled 
depends on how far down the left window border the mouse cursor is when you invoke 
the command. The window scrolls up so that the top line moves down to the mouse 
cursor. The rightBack option reverses the scrolling direction of the mouse button. If 
the rightBack option is 2 or 3, the text line next to the mouse cursor becomes the 
bottom line of the display. 


[ #14,(PgUp) , ( , left border) ] 


6.4.9 Scroll Left 


Move the window to the left. 


[ , bottom border) | 


6.4.10 Scroll Right 


Move the window to the right. 


[ ( , bottom border) } 
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6.4.11 Thumb Vertical 


Move window to a specific area in the document. Imagine the document laid out along 
the left border. The mouse cursor indicates where in the document you want to go. The 
window will be positioned so that the top of the elevator (the left border highlight) starts 
where the mouse cursor is when you thumb. Corners are not part of the left border and 
cannot be used for thumbing. 


Ke , left border)] 
6.4.12 Thumb Horizontai 
Move window left or right depending on where on the bottom border you click. 


[c , bottom border)] 


6.4.13 Search For String 


A prompt is displayed for the search string. If the selection is in the window, a search is 
made from the point of selection to the end of the file. If the selection is in another 
window, the entire file is searched. The search ignores case unless ignoreCase is set to 
0. The default search string is the last string searched for. This string is automatically 
inserted as a response. Pressing accepts this as the search string. If you press 
first, it erases the last character of the default string and lets you continue 
editing with more backspaces or new characters. Pressing any other key first erases the 
default string and starts a new string. 


A find is displayed in character mode. If the string is already in the window, the window 
is not changed. If the string found is not in the window, the window is changed to show 
the string found on the third line of the display. The window is topped when the string is 
found only if the topOnFind option is set to 1. The searchMode option determines 
whether the search proceeds forwards, backwards, or circularly. 


In a search string the following escape sequences are valid: 


" \n "represents the end-of-line character (ASCH 13 followed by ASCII 10) 
" \N "represents the line feed character (ASCII 10) 

" \x "represents the carriage return character (ASCII 13) 

" \\ "represents a single backslash character ( \ ) 


[ #19, ( TShift , MOVING menu, find on the top line ] 
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6.4.14 Search For Selection 


This is the same as search for string, except the current selection is used as the search 
string. The selected search string can include one or more end-of-line characters. You 
can select a string in one window and search for it in another window. 

[ #27, , MOVING menu, next on top line ] 


6.4.15 Search Backwards 


This is like search for selection, except the search goes in the opposite direction. Unless 
searchMode is set to 1, this is from the selection to the beginning of the file. 


[ #66, , , MOVING menu, prev command on top line ] 


6.4.16 Replace String 


Replaces occurrences of a string with a different string. The string to search for is 
requested first. Then, the string to replace it with is requested. Both search and replace 
strings can contain the escape sequences \n, \N, \r, or \\ as described in the 
search command (above). Next, you are asked whether the replace operation should take 
place only within the current selection or from the current selection to the end of the file 
(a "global replace"). Finally, you are asked to indicate whether you want to verify each 
replacement or replace them all without verification. If you choose to verify each 
change, makes the replacement, (N) does not replace, but goes on to the next 
occurrence of the string, and terminates the replace operation. 


[ #20, [R}], EDITING menu ] 


6.4.17 Beginning of File 


Positions the window at the beginning of the file. 


[ #8, (Ctrl}{PgUp) I 


6.4.18 End of File 


Positions the window at the end of the file, with the end-of-file marker on the bottom line 
of the window. 


[ #9, (Ctr}{PaDn)] 
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6.4.19 Beginning of File and Move Selection 


This command works like the Beginning of File command but it also moves the selection 
to the first character of the file. It is can be used before a search or replace that you want 
to start at the beginning of the file. 

[ #78 ] 


6.4.20 Go To Line Number 


You are prompted for a line number. The window is repositioned so that the requested 
line number is the top line in the window. 


[ #16, , MOVING menu ] 


6.4.21 Go To Selected Line Number 


The selection is taken as a line number. Nondigits at the beginning of the selection are 
ignored. The window is repositioned so that that line number is the top line in the 
window. 


[ #84, Alt HF9) , (Ctr }F9)] 


6.4.22 Go To Last Place 


The window is repositioned to the last place you came from with a nonrelative motion 
(that is, not a scroll). This is the last place you jumped from with one of these 
commands: go to line number, go back to last place, search, beginning of file, or end of 
file. A separate "last place" is remembered for each window. 

[ #56,(F3] , MovVING menu ] 


6.4.23 Go To Selection 


The window containing the selection is made the top window and repositioned so that the 
selection is near the top of the window. 


[ #58, [ TShift , MOVING menu J 


6.4.24 Find Matching Bracket 


The bracketing character that matches the first selected character is searched for. The 
allowed bracketing characters are(, ), [, ], {, and}. The file is searched in the correct 
direction and the matching bracket is found, taking nesting into account. 


[ #83, (ftShitt}{F8)] 
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6.5 Menu Commands 


To use pull-down menus. move the mouse cursor to the top line. Then press and hold 
on the (upper case) menu name. When the menu appears, select a menu option 
with the mouse cursor. In the menu, the command is the color of the selected text. 


If you release the on a command string, that command is carried out. If you 
release the mouse button outside the menu, no command is executed. 


(Esc) exits from a menu without selecting anything. executes a command in the 
same way as a mouse button click. 


6.5.1 Top line Commands 


Commonly used commands are listed on the top line. Click on one of these to 
be execute the command . It is possible to put any command on the top line (and give it 
any name) by modifying PT.INI. 


PT.INI also lets you have: 


e Several top lines, each accessed by a different button 
e A bottom line of menus and commands instead of a top line 
e Pop-up mouse menus. 


6.5.2 User Menus 


These commands display the eight user-defined menus and allow you to select a 
command from them. They can be displayed as top line menus, bottom line menus, drop- 
down menus (from the top line), or as pop-up menus. 


[#50 (1), #51 (2), #52 (3), #60 (4), #65 (5), #67 (6), #79 (7), #80 (8)] 


6.5.3 TOPLIST Menu 


A menu is displayed that lists the file names of the files in all open windows. The file 
names are shown from the top window to the bottom window. If there are hidden 
windows, they are listed after the list of visible windows (a double line divides the two 
lists). Selecting file name from the TOPLIST menu will top that window. Selecting the 
file name of a hidden window unhides and tops the window. 


[ #53, (Alt }X)1 
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6.5.4 OPTIONS Menu 


A menu of POINT options is displayed. The option to be changed has to be selected 
Options are changed in two ways. True/false options toggle from true to false to true 
when selected. Numeric or string options display a prompt for a new value. The default 
input is always the current value of the option. exits option setting with no 
changes. 

[ #63 ] 


6.5.4.1 Interactive Color Settings 


textColors, borderColors, and msgColors option show the color settings. Each 
setting is two hexadecimal digits. 


textColor Shows the color setting for the text and the selection. 
borderColor Shows the color setting for the banner line, the border and the elevator. 


msgColor Shows the color setting for the Info Message, User Input, 
Error Message, and Topline. 


Selecting textColors, borderColor or msgColor puts you in color setting mode 
where you can set the colors of the active window or any of the other POINT color 
settings. (Esc) exits color setting mode with no changes. 


The color setting mode will display a screen with three major parts. 


The top is a menu line with 10 commands. Nine of these are used to change the color of 
the display. The part that will be changed is selected by clicking on its name on this 
menu line. The tenth command exits interactive color setting. 
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The second part of the screen is a line of four commands and a menu of the 128 possible 
combinations of foreground and background colors you can select from. Select a color 
combination by clicking on it. The commands allow you to look at another 128 color 
combinations (the alternate colors) which will either be blinking or have bright 
background colors. Two of the commands switch you back and forth between the plain 
and alternate color sets. The other two commands change the alternate color set from 
blinking to intense and back again. 


NOTE 


Commands to switch between blinking and intense colors reprogram the 


hardware: their effect will persist until you turn off your machine. 


The third part of the screen is a sample window showing how the selected color 
combination will look, and samples of the four other display parts. 


Pressing while in color setting mode returns you to editing without making any 
color changes. 


Click on the Exit menu item on the top part to exit the color selection mode. 
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6.5.4.2 Redefine Keys, Buttons and Mouse Motions 


This lets you interactively change the definition of a key, mouse button or mouse motion 
subcommand. It is useful when you need an easy-to-issue command. For example, you 
might want to change to issue the change case command so that you can quickly 
change the case of a sequence of words. 


The feature is accessed through the OPTIONS menu item Redefine... When you 
select Redefine... you are asked what type of action you want to redefine. 
Redefinition options are: 

k a key 


POINT asks you to press the key you wish to redefine. Then it asks you for the 
new command to assign to that key. This process is described below. 
mouse button 


POINT asks you to press the mouse button you wish to redefine. Then is asks 
you for the command to assign to that button. You can also redefine a 
combination mouse button : , or . (Do this in PT.INI also.) 
Just press (Att), or and then the click the mouse button. 


subcommand of the first mouse motion command 


subcommand of the second mouse motion command 


1 or 2 prompts you for the subcommand direction. The options are a compass 
point (n, ne, e, se, s, sw, w, or nw) followed by the key, or the key 
alone to redefine the no motion command. 
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After you select the action to be redefined, POINT displays directions on line 24 of the 
screen, and a command number and command description on line 25. These are the same 
one-line descriptions you see if you have the helpMode set to 1 or 2. The first command 
you see is the command currently assigned to the action you specified. 


You can scroll up and down through all the possible commands (presently there are about 
ninety (90) POINT commands) with the and cursor keys. You can jump 
directly to a command by typing its number. A one digit command number must be 
preceded by a 0, or followed by the key. 


When the command you want is showing, press to complete the redefinition. 
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6.6 Mouse Motion Commands 


Mouse motion commands make it possible for you to execute a specified command by 
simply moving the mouse in one of eight directions on your desk/screen. 


6.6.1 Issuing a Mouse Motion Command 


The mouse motion command is assigned to a mouse button. The mouse motion 
command has nine associated subcommands. You issue a subcommand by pressing the 
mouse button, moving the mouse at least one character in one of the eight compass 
directions, or not move at all and then releasing the mouse button. The directions are: 


N north or up 

NE north-east or up and right 

E east or right 

SE south-east or down and right 
Ss south or down 

sw south-west or down and left 
Ww west or left 

NW north-west or up and left 


no movement 


POINT only looks at where you press the mouse button and where you release it to 
determine which direction you went. 


While the mouse button is depressed, POINT gives you feedback as to which command 
it will execute if you were to release the button at that point. The feedback is an arrow 
pointing the direction you have moved (or a single dot for the no motion command). If 
you have helpMode set to 1 or 2 then a one line description of the command is given on 
the bottom line of the display. It is recommended that you set helpMode=1 or 
helpMode=2 while you are learning to use the mouse motion commands. 


A ninth subcommand is the no motion command. It is issued if you release the mouse 
button at the same point as you pressed the button. This command is easily issued as a 
fast click of the mouse button. Therefore this should be the most commonly used 
command of the nine mouse motion subcommands. 


6.6.2 Canceling A Mouse Motion Command 


Pressing a second button cancels the mouse motion command. 
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6.6.3 Default Mouse Motion Subcommands 


You can specify the nine subcommands of the mouse motion command (see section 3.3.5 
for information on how to do this). The default commands are: 


previous 
delete 
/ 
/ 
duplicate 
/ 


The command numbers are: 


duplicate #2 
previous #66 


delete #4 

move #70 
insert #55 
next #19 
redo #24 
copy #69 
undo #25 


These rules will help you remember these commands: 


downward strokes are positive (redo, next, insert) 

upward strokes are negative (undo, prev, delete) 

they are paired, down and up (redo/undo, next/prev, insert/delete) 
diagonal strokes make editing changes 

horizontal strokes do copy and move 

vertical strokes do searching 
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6.6.4 Second Mouse Motion Command 


The second mouse motion command is for people with a three button mouse who want to 
assign two mouse buttons to mouse motion commands. 


[ #46 ] 


The default subcommands of the second mouse motion command are: 


move to 
last place 
| delete- 
window | no scrap 
| / 
\ | 7, 
copy to <--- extend ---> exchange 
scrap / |N with scrap 
/ ) oN 
/ | \ 
bottom | cancel 
window | 
TOPLIST 


The command numbers are: 


extend #39 

move to last place #56 
delete/no scrap #61 
exchange with scrap #62 


cancel #22 
TOPLIST #53 
bottom #29 

copy to scrap #57 
close window #17 


The second mouse motion commands can be changed in PT.INI! with lines of the form: 
nN=commandNumber 


where N is 0, 1, 2, 3, 4, 5, 6, 7, or 8 as in the chart above. 
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6.7 Editing Commands 


6.7.1 Copy 


There are several ways to copy text: the copy command, the duplicate command, 
and via the scrap buffer. 


6.7.1.1 Copy 


Select the text to be copied. Move the mouse cursor to the point where you want to copy 


the selection. Now, press (fShift] and click . The text will be copied to the 
place where you release the({m QQ). If the selection is in word or line mode, it will be 
copied in front of the word or line where you release the mouse button. 


[#69, (fShift}{m@ Q QJor(fShit QO my] 


Step 1: Select the text you want to copy. 
Step 2: Move the mouse cursor where you want to copy the selected text. 


Step 3: Press(fShift) and click the mouse button. 


If you select the insertion point in character mode, then the text is copied in 
front of the character you are pointing at. 


If you select the insertion point in word mode then the text is copied in front of 
the word you are pointing at. 


If you select the insertion point in line mode then the text is copied in front of 
the line you are pointing at. 
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6.7.1.2 Copy To Scrap 


This copies selected text into the scrap buffer. The mode (character, word, or line) of the 
selection is remembered and used when the text is inserted. 


[ #57, ( TShift , EDITING menu ] 


6.7.1.3 Copy with Scrap Buffer 
This method uses the scrap buffer for insertion of text. Move the cursor to where you 


1 noaint wr tn f } a | yes ee | 
want the text copied, select that point with the | ™ UO Qj, and press| ins). 


If the text in the scrap buffer was selected in word mode or line mode, then it will be 
inserted in front of the character, word, or line that contains the insertion point. You can 
insert the same text from the scrap as many times as you want. 


[ #55, (Ins) ,(F2)) 


6.7.1.4 Duplicate 


Press where you want to copy the duplicated text and press (F4). 
Then select the text to be duplicated and press (F4) again. 


[#2,(F4Jand(@OO)] 


Step 1: Select the insertion point for the text you want to copy (this is the reverse order 
from the copy instruction). 


Step 2: Press(F4) to go into duplicate mode. 
Step 3: Now, select the text to be copied. 
Step 4: Press(F4) again. The selected text will be copied to the insertion point. 


This ends duplicate mode. The new insertion point is the first character after the 
copied text. 


While in duplicate mode you can execute commands, such as scrolling windows, 
topping windows, searching for text, creating new windows, etc. 


Use duplicate to copy several things to one place. 
Use copy if you already know where you want to insert the text. 


An easy way to duplicate is to select a section of text and then press twice. 
This is especially useful for duplicating one or more lines of text. 
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6.7.2 Move 


You can move text with the Move Text or with the Extract command 


6.7.2.1 Move Text 


Select the text to be moved. Then move the mouse cursor where you want to move the 


text. Then while holding down key, click . Text is moved to the place 
where you release the button. If selection is in word or line mode, the text is put 
in front of the word or line where you release the button. 


[ #70, CIeK=}) 
6.7.2.2 Extract 
Press where you want to place the extracted text, and press 


Then select the text to be extracted and press again. 
[ #3, , and mouse button ] 
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6.7.3 Redo and Undo 


The last 50 editing actions in your current session are recorded in a change history, 
which is used by the Undo and Redo commands. undoSize determines how many 
changes are remembered in the change history (50 is the default; 100 is the maximum). 


Some actions carinot be undone or redone, such as the following: 


load file, write file, close window, search, redraw, change selection, 
change window size, scroll a window, move a window, top a window, 
bottom a window, or exit the editor. 


by itself cannot be redone. 
Thus, deletes are ignored when looking for the last action to redo. 


[ #24, (F8)] 


6.7.3.1 Redo 


Most editing actions can be redone. A redone action is recorded in the change history 
and can be undone. 


The sequence "select text, delete, and type new text at the same point" is recorded as one 
action in the change history. 


redo repeats the last action in the present environment. 
redo copy copies the last text that was copied into the present insertion point. 


redo move acts exactly like redo copy, since the moved text is already gone from its 
original spot, and presumably you do not want to move it again from where you just 
moved it. 
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6.7.3.2 Reversible Undo 


Undo Last Edit reverses the last editing action. A delete is restored. A copy is deleted. 
A move is deleted and reinserted where it was originally. 


If the last action was to select text, delete it, and then type new text all at the same point, 
then this action is undone as a unit, that is, new text is deleted and old text is restored. 


The undoing change is recorded in the change history so a second Undo Last Edit 
undoes the first Undo. If the undoBack is set to 1, then Undo Last Edit acts like 
Undo, Erase History. You cannot undo changes if you have saved the file since the 
changes were made. 


[ #25, ,(F9) , EDITING menu ] 


6.7.3.3 Undo, Erase History 


This acts like Undo except that it doesn’t record the change in the change history, and in 
fact removes the change being undone from the change history. Thus, a second 
Undo, Erase History undoes the change before that. 


Undo, Erase History undoes up to 50 previous edits. The undoSize option 
determines how many previous edits are saved. The window will be moved to where the 
undo will take place before the change is made. You cannot undo changes if you have 
saved the file since the changes were made. 


[ #40, { TShift , EDITING menu ] 


NOTE 


If you use undo and then decide to undo more than one step you have to use 
Undo, Erase History two extra times: one to undo the undo, and a second to 
undo the first undo! 


If you prefer Undo, Erase History as the default, set undoBack to 1. 
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6.7.4 Keyboard Macros 


6.7.4.1 Begin/End Recording Macro Keystrokes 


This begins recording keystrokes in the keyboard macro buffer. Keystrokes are recorded 
until this command is executed again. There is only one keyboard macro buffer. 


[ #76, Cait }{(M)} 


6.7.4.2 Piay Back a Keyboard Macro 


Keystrokes in the keyboard macro buffer can be played back at any time as if they were 
typed on the keyboard. 


To define and use a macro, do the following: 


Step 1: Execute Begin/End Recording Keystrokes. This records each keystroke 
that follows in the keyboard macro buffer. The keystroke commands are 
executed as you type them, so you are defining the macro by example. 


Step 2: Execute Begin/End Recording Keystrokes again, to stop recording 
keystrokes and define the macro. 


Step 3: Run the macro with Play Back Macro. This plays back keystrokes in the 
keyboard macro buffer just as you recorded them. 


[ #77, (Alt }(P)] 


NOTE 
There is only one keyboard macro buffer, so if you record another macro, the 


previous one is lost. 
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Here is a keyboard macros to indent a section of code: 


Step 1: Position the cursor on the first line to be indented, 
Step 2: Press ; 

Step 3: Press ; 

Step 4: Press(<] (cursor key). 

Step 5: Press (cursor key). 

Step 6: Press 


Step 7: Press (P} once for each line to be indented. The macro inserts the 5 
moves to the beginning of the line, and down one line. 
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6.8 Quit Commands 


The following actions exit POINT in a various ways, according to what is done with the 
files which have been modified during the editing session. 


6.8.1 Quit-Ask About Files 


Exits the editor. If any files have been changed but not saved, you are asked about each 
one. Press (Y]} to save the new version of the file, or [NJ to leave the original version 
unchanged. It will not accept any other keyboard input. You can also move the mouse 


cursor to the bottom of the screen and respond for Yes and for No. The 


editor is exited. 
If you press{ Esc) , the quit action is abandoned. 
[ #5, [Q), QUITSETC menu ] 
6.8.2 Quit-Save Files 


All files that have been changed but not saved are automatically saved. Exits the editor. 
[ #48,(F2), gurreEtc menu ] 


6.8.3 Quit-Discard Edits 


If files have been edited a single verify is requested. Exits the editor without saving files. 
[ #49, QUITSETC menu ] 
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6.9 Execute DOS Commands 


6.9.1 DOS Command Window 


Selected text is taken as a DOS command and passed to the DOS command processor for 
execution. The standard output of the command is saved in a temporary file. When the 
command completes, a new window is created and the standard output of the command is 
displayed there. You can redirect either the standard input or the standard output of the 
DOS command on the command line (the selection). If you redirect the standard output 
the window created by the POINT Editor will be empty when the command completes. 

[ #30, QUITSETC menu ] 


6.9.2 DOS Command Shell 


The screen is cleared, and a copy of the DOS command processor is executed. You can 
execute any DOS command using it. When you exit with the "exit" command, you are 
returned to the editor and the screen is redrawn. The output of the commands executed is 
not saved. The directory that was current when you invoked the POINT Editor is 
restored after you exit from the DOS command interpreter, but the current directory you 
were last in is restored if you invoke the DOS command interpreter again. 


[ #32, [D}, QUIT&ETC menu ] 
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6.10 Miscellaneous Commands 


6.10.1 Help 


If helpMode is1 or 2, the help screen is shown for the last command you selected from 
the top line or from a menu (even if you did not actually execute the command). 
Otherwise you are shown the main help menu. 


[ #64, Alt }H)] 


6.10.2 Toggle 43-line Mode 


Switches between 25-line mode and 43-line mode. The 43-line mode is only available 
with the Enhanced Graphics Adapter. 


[ #68, (At }{7)] 


6.10.3 Fill Lines To RightMargin 


This fills lines so that each contains as many words as possible between column 1 of the 
text and the right margin defined by "rightMargin". "Word" means a string of characters 
separated by space characters. Space characters are spaces, tabs and end-of-lines. 


When this command is invoked it performs this fill operation on all the lines that have 
any selected characters (it is not necessary to select the whole first and last lines, just one 
or more characters in each). 


This command always uses column 1 as the left margin. If you want the block of text to 
be indented you can do this is three steps: 

Step 1: Reduce rightMargin by the indent desired. 

Step 2: Justify the lines. 

Step 3: Indent the lines. 


Indent lines with the replace command by replacing \n with <tab>\n (where <tab> is the 
tab character). This indents by one tab. Other indents are possible with similar replaces. 
Alternatively, you can use the keyboard macro facility to indent the lines one at a time. 

[ #85 ] 
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Notes: 


POINT Features 


Appendix A 
POINT Features 


Specifications 
Maximum number of windows 20 
Maximum number of open files 20 
Maximum number of buffers 140 


Minimum window size 


3 rows by 10 columns 


Maximum line size any length 
Maximum input string 100 characters 
Maximum search string 50 characters 
Maximum replace string 50 characters 
Maximum number of menu characters 2500 characters 
Maximum number of undos 100 
Maximum disk buffers 300K 
User defineable menus 8 
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Appendix B 
Command Numbers 
The following table shows command functions that can be attached to keys as defined in 
the PT.INI file. 
The format for this definition is 


k<N>=<Command Number> 


where 


k or K indicates that a key is about to be defined, 
<N> is one of the key codes defined in Section B.1, and 
<Command Number> is a number defined in Section B.2. 
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B.1 Key Codes 


Extended Code Characters 


003 
015 Shift 


016-025 CALL) plus (Q) (W) () &) OOF 
030-038 CAlt_) plus (A) (S) (D) (F) (4) (L) 


ee Al 


044-050 (Alt ) plus (Z) (N) (Mm) 
059-068 through (unshifted) 


EE 


071 
072 
073 
075 
077 
079 
080 
081 
082 {Ins} 
083 
084 - 093 through (TShift }{F10) 
094 - 0103 Ctrl through 
0104 - 0113 through (Alt }{F10) 
0114 Ctrl PrtSc 
0115 
0116 Ctrl). 
0117 
0118 Ctrl PgDn) 
0119 
0120-031 rs ONAOMAOONDDODOOL 
0132 
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Window 
Management 


Position Window 


Position File 
in Window 


Number 


Command Functions 


B.2 Function Codes 


Command 


New Window 

New Window From Selection 

Hide Window 

Close Window 

Close Window And Save File 

Split Window 

Redraw Screen 

Change Color Combination in Window 


Top Window 

Bottom Window 

Top/Bottom Window 

Zoom Window 

Change Window Size 

Stretch Window From A Corner 
Move Window 

Exchange the two Top Windows 


Scroll Down 

Scroll Up 

Scroll Left 

Scroll Right 

Thumb Vertical 

Thumb Horizontal 

Search For String 

Search For Selected String 

Search Backwards For Selected String 
Replace String 

Go To Beginning Of File 

Go To End Of File 

Go To Line Number 

Go To Selected Line Number 

Go Back To Last Place 

Go To And Show Selection 

Finding Matching Bracket 

Beginning of File and Move Selection 
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File Commands 


Insert Characters 


Copy And 
Move Text 


Redo And 
Undo Edits 


Quit Commands 


Command 


Load A New File Into Active Window 

Load Selected File Name Into Active Window 
Save File In Window 

Save All Unsaved Files 

Save File In Window Using Another Name 
Toggle Read-Only Status of File. 


alart Tavt 
Wht LYALL 


Extend Selection 


Insert Character 
Insert ASCII Character 


Copy Text 

Duplicate Text 

Move Text 

Extract Text 

Delete Selection to the Scrap Buffer 
Delete Selection but Preserve the Scrap Buffer 
Copy Text To Scrap Buffer 

Insert Text From Scrap Buffer 
Exchange Selection with Scrap Buffer 
Cancel 

Toggle Insert/Overtype Mode 


Redo Last Edit 
Undo Last Edit (Reversible) 
Undo Edit (Multiple Step Undo) 


Quit And Ask About Unsaved Files 


Quit And Save All Unsaved Files 
Quit And Discard All Edits 
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Execute 
DOS Commands 


Macro Commands 


Miscellaneous 
Commands 


Invoke 
Menu Commands 


Keyboard 
Cursor Movement 
Commands 


Command Functions 


Command 


Execute Selection And Put Output In A Window 
Escape To A DOS Command Interpreter 


Begin/End Recording Keystrokes 
Play Back Recorded Keystrokes 


Set Value of the "debug" Variable 
Display POINT Information 
Invoke Help System 

Toggle 43-line mode (EGA) 

Fill lines to Right Margin 

Change case of a letter 


Invoke User Menu 1 
Invoke User Menu 2 
Invoke User Menu 3 
Invoke User Menu 4 
Invoke User Menu 5 
Invoke User Menu 6 
Invoke User Menu 7 
Invoke User Menu 8 
Invoke TOPLIST Menu 
Invoke OPTIONS Menu 


Move Cursor Up 

Move Cursor Down 

Move Cursor Left 

Move Cursor Right 

Fast Cursor Movement 

Move Cursor to the Edges of the Window 

Move Cursor to the Edges of the Screen 
Simulate Mouse Buttons 

Move Cursor One Word (Blank Delimited) Left 
Move Cursor One Word (Blank Delimited) Right 
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Appendix C 
POINT Extensions 


A POINT extension is a file which you can load and execute to extend the functionality 
of eh POINT Editor. POINT loads the extension on demand, and unloads it when it 
terminates. 


An extension can be designed to remain resident in memory until space is needed to load 
another extension, or until you issue a command to free the memory. In this way often- 
used extensions do not need to be loaded again and again. 


A primary extension may work together with another, secondary, extension. The 
secondary extension may be terminated independently of the primary extension. All 
extensions secondary to a primary extension will be terminated when the primary 
extension is terminated. 
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Calling POINT Extensions 


Fifty-six (56) commands (#200 through #255) are available for calling POINT 
extensions. You can set them up in the PT.INI file as follows. 


Assign a character string to any of these 56 commands. The character string begins with 
the name of the extension followed, where needed, by an argument. These arguments are 
passed to the command when it is executed. If the string ends with a space, the user is 


aemennentn A fre in manta tr tha nnaemman 


AAs ARAL ACoe 
prompted for additional arguments to the command. 


An extension is treated as primary if its name is immediately followed by an * (asterisk). 
An example of an extension is M2ASSIST, as described in Appendix D. 
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Appendix D 
The M2ASSIST Environment 


What M2ASSIST Does 


M2ASSIST integrates the POINT Editor with the LOGITECH Modula-2 system. It lets 
you check the Modula-2 syntax of your program, compile it, look at compilation errors, 
link, and run, without exiting POINT. 


These and other M2ZASSIST functions are described on the following pages. 
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Check Syntax 
Check Syntax checks the Modula-2 syntax of text in the active window. 


It highlights the line of text where the first error has occurred, and uses the bottom line of 
the screen to display the error message associated with the error in that line. 


Compile 
Compile lets you compile the file in the active window. 
Compile begins by asking for compiler options. 
You are prompted the last-used option. lets you abort the request. 
It saves the file in the active window and clears the screen. 
It then runs the overlay version of the LOGITECH Modula-2 Compiler. 


If it detects an error in the file, the compiler creates a .LST listing file. The source file is 
tagged with error messages from the listing file for examination with the Next Error 
function. 


Current error messages are discarded if the window is closed, or if the file is saved or 
recompiled. 


When compilation is done, any key or mouse button returns you to the editing session. 
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Find Next Error 


Find Next Error highlights the next statement in the active window tagged with a 
compilation error message after invoking Compile or Load Listing. 


You can insert/delete lines of text in the file and then go to the next tagged error. 


Corresponding error messages from the .LST file show in a temporary error window at 
the bottom of the screen. 


The error window closes at the first user action. 


Link 
Link links the .OBJ file associated with the active window. 
Link begins by asking for linker options. 
You are prompted for the last-used option. (Esc) lets you abort the request. 
Link clears the screen and calls the LOGITECH Modula-2 Linker. 


When linkage terminates, pressing any key or mouse button returns you to the POINT 
editing session. 


Run 
Run executes the .EXE file associated with the active window. 


When execution terminates, press any key or mouse button to return to the POINT 
editing session. 


Load Listing 
Load Listing reads the .LST file associated with the active window. 


Error messages are tagged in the source file and can be looked at sequentially with 
Find Next Error, as explained above. 
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Load Templates 


Load Templates loads the file M2ASSIST.INI, which contains templates for 
Modula-2 constructs. 


A template is a sequence of characters which can be inserted in the active window at the 
current cursor position. 


The _ (underscore character) in the template tells the cursor where to appear after the 
template is inserted. 


A template is identified by @ , followed by a letter in the set [a..z]. 


Here is a template from the current release of M2ZASSIST.INI. 


@h 

(* 

Title: <title> 

LastEdit: <current date and time> 
Author: <author> 

System: LOGITECH MODULA-2 Version 3.0 
(* 


Text following the @h is inserted at the cursor position in the active window. 
The cursor is then repositioned just before <title>. 


Quit M2ASSIST 


Quit M2ASSIST releases the memory used by M2ASSIST. 


Help 
_ Help contains general information related to MZASSIST functions. 


Press any key or mouse button to return to the editing session. 
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How M2ASSIST Runs — About POINT Extensions 


M2ASSIST is an extension of POINT (See Appendix C). 


The current release of M2ASSIST actually consists of two extension modules: 
M2ASSIST.PTO and CHECKER.PTO. 


M2ASSIST.PTO is a primary extension and CHECKER.PTO is a secondary extension. 
The functions of M2ZASSIST.PTO are: 


Argument Function 

Quit 

Compile 

Goto Error 

Link 

Read Listing 
Run 

Read M2ASSIST 
Help 

Template 


NA unk WO NY HB @ 


® 
* 


CHECKER.PTO has no arguments. 


D - 143 


Appendix D 


To run M2ASSIST, you must bind a key to a specific M2AssrsT function in the PT.INI 
file. 


Consider the following lines in PT.INI: 


c201="m2assist.pto 1" 
k063=201 


These lines bind function key (k063) to command 201, which specifies the 
Compile function from M2ASSIST.PTO. Note that M2ZASSIST is defined as primary. 


Analogously, to bind CHECKER.PTO to(F2] , place the following lines in PT.INI: 


c202="checker .pto" 
k060=202 


To bind a key to a template in M2ASSIST.INI, give the template name as an argument to 
M2ASSIST.PTO. 


For instance, these lines 


¢210="m2assist.pto @x" 
k064=210 


insert template @x at the cursor position when you press (F6) . 


The distributed file PTM2.INI is an example of an initialization file set up to recall the 
M2ASSIST function. 
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Appendix E 
Non-Mouse Reference 


If you work on more than one system, you will occasionally work on one without a 
mouse. For this reason, a non-mouse interface is included here. Although non-mouse 
use is only occasional, we have made it as close as possible to the mouse interface. 


Cursor keys move the mouse cursor, and other keys simulate mouse buttons. 


Mouse button keys simulate a completed click rather than a press or a release by itself: 
you can’t hold down a simulated mouse button. 


Some mouse commands are simulated by two keystrokes on the numeric keypad on the 
right side of the keyboard. 
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First Key 


Gray 


First Key 


Gray (©) 


Mouse Simulation Command Table 


Next Key 


Moves Mouse Cursor... 


1 space left 
1 space right 
1 word left 
1 word right 


1 row up 
1 row down 


Cursor Moves... 


10 columns left 

10 columns right 

6 rows up 

6 rows down 

6 rows up and 10 columns right 

6 rows down and 10 columns right 
6 rows up and 10 columns left 

6 rows down and 10 columns left 


Next key moves within window to... 


Left edge of window 
Right edge 

Top edge 

Bottom edge 

Top border 

Bottom border 

Left border 

Right border 
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First Key 
Next Key 


JOH 


da 


< 

oO 
al 

co) 


First Key 
Next Key 
End 


Q 
Sy C) 
2a Bab 


fad o 


q) 
i 
we 
WO) 


Non-Mouse Reference 


Next key moves within screen to... 
Left edge of screen 

Right edge 

Top edge 

Bottom edge 


Next key moves within window to... 


Middle of window 
Middle of window 


Next key moves on the line to... 


Beginning of line 
End of line 


Next key simulates mouse click... 


” 
= 


>i => 
2] Ke?) 
aya 
hE] | 


: 
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Using Mouse Keys with a Mouse 


Mouse simulation keys work differently if you use a mouse. 


Cursor movement keys move the mouse cursor and the selection. This is normally what 
you want when you have a mouse since it saves additional keystrokes to move the 
selection after the mouse cursor is moved. Since the selection moves, the screen must be 
redrawn after each cursor movement command. This makes these commands somewhat 


elawer 
WAV VY Whe 


If cursorMouse is set to 1, mouse cursor simulation will only move the mouse cursor 
even if a mouse is present. 


Quick Reference 


Appendix F 
Quick Reference 


The following pages contain reference tables of keyboard and mouse button actions. 
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A 


EY 


3 
_—s 


3 


2 


(3 
ié) 


8 
h 


F5 


F 


i [B 


8 
as | 


B 
© 


FQ 


Fi 


(2) 


Delete 
To Scrap 


Insert from 
Scrap 


Quit & Save 
All Files 


Duplicate 
text 


Extract text 


Search for 
Selection 


Go Back To 
Last Place 


Redo Last 
Edit 


Undo Last 
Exit 


Redraw the 
Screen 


Function Keys 


Delete, 
Not to Scrap 


NO ACTION 


Quit & Discard 
All Edits 


Copy to 
Scrap 


NO ACTION 


Search for 
String 


Go To 
Selection 


Find Matching 
Bracket 


Undo, Erase 
History 


Load Selected 
File Name 
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(At) or (Ctrl) 


NO ACTION 


NO ACTION 
Quit & Ask 
About Files 
NO ACTION 
NO ACTION 


Search 
Backwards 


Go To Line 
Number 
NO ACTION 


Go to Selected 
Line Number 


New Window 


Selected File Name 


358 
(9}[2} > 


> 
© 


eee 
SE) 


E 
A 


: 
= 


z 
2) 


ee 
2} [9] [2}(Q} 


E 
@ 


ace 
BiGi& 


pd | Pa 


Sis 


Quick Reference 


Alt-Letter Keys 


Enter ASCII character. 

Bottom the active window. 

Close the active window. 

Execute the DOS command interpreter. 
Exchange the selection with the scrap. 
Goto line number. — 

Enter the help system. 

Display debugging information. 

Load new file into the active window. 
Record keystrokes in the macro buffer. 
Create new window. 

Toggle overtype mode and insert mode. 
Play back keystrokes from the macro buffer. 
Quit and ask about unsaved files. 
Global replace. 

Save file in the active window. 

Toggle 43 line mode. IBM EGA only. 
Undo. 

Write file in the active window. 

Hide the window. 

Zoom or unzoom the active window. 
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Keypad Cursor Keys 


Key 


Ctrl} — Back 
Ctrl H Break 


Command 


Scroll up 

Scroll down 

Go to End of file 

Go to Beginning of file 


Move cursor to edge of screen 
Simulate mouse buttons 


Move mouse cursor one space in any direction 
Move mouse cursor one word (blank-delimited) left 
Move mouse cursor one word (blank-delimited) right 


Fast cursor motion 
Move cursor to window edges and corners 


Delete selection to scrap 
Insert from scrap 

Delete previous character 
Delete previous word 


Cancel command 
Stop current editor action 
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Cursor 
Position 


Outside 
Window 


Inside 
Window 


Any 
Corner 


Top 
Border 


Right 
Border 


Left 
Border 


Bottom 
Border 


Mouse Command Chart 


NO ACTION 


Select 
text 


Toggle window 


top/bottom 
Activate 
window 

NO ACTION 


Scroll Up 


Scroll Left 


TOPLIST 
menu 
TOPLIST 
menu 


NO ACTION 


Split window 
(vertical) 


Split window 
(horizontal) 


Thumb 
(by line) 


Thumb 
(by column) 


D - 153 


Quick Reference 


NO ACTION 


Extend 
selection 


Stretch 
window 


Move 
Window 
NO ACTION 


Scroll Down 


Scroll Right 
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INDEX 


POINT Index 


A 


Active window, 19, 22, 27 
[Alt] keys (default), 151 
ASCII code, 38 
AutolIndent, 53 


B 


.BAK files, 95 
Banner line, 19, 84, 85 
Beginning 

of file, 107 

of line, 45 

of selection, 34 
Borders, 86 
Bottom, 

window, 110 

line, 82, 83 
Buffer, 53 


Cc 


Color, 

codes, 59 

interactive settings, 110 

options, 83, 94 
Column numbers, 61, 131 
Command line options, 97 
Comment Line, 14 
COMSPEC, 54 
CONFIG.SYS, 10 
Configuration, 10 
Copy, 33,117 

duplicate, 35, 118 

from scrap, 33, 118 

with mouse, 34 
Cursor, 13, 


D 


Define key specifications, 112, 112 
Delete 
text, 90 
Display, monitor, 10 
color, 58 
enhanced graphics adapter, 58, 126 
monochrome, 10, 58 
video attributes, 58 
DOS 
command interpreter, 125 
command shell, 42 , 125 
file handles, 10 
Double click, 19 
Double line border, 86 
Duplicate text, 35, 118 


E 


Edges and borders, 86 
EDITING menu, 36 
global replace, 38 
insert ASCII characters, 38 
redo last edit, 36 
undo last edit, 37 
Elevator, 86 
End-of-file, 107 
End-of-line character, 87 
Enhanced Graphics Adapter (EGA), 
Erase history, 121 
Escape, 99 
Extend selection, 89 


Extensions, 137 


POINT Index 


F 


Files, 84,95, 104 
DOS file manipulation, 
handles, 10, 95 
names, 84 
patterns, 54, 94 
Load file from selection, 104 
POINT files, 8 
INI files, 8 
PT.EXE, 8 
PT.HLP, 8 
PTTEMP.XXX, 95 
UNNAMED.X, 95, 100 
Read-only files, 96, 105 
Save file, 104 
View a file, 25 
Flicker, 58 


G 


Go back to last place, 108 
Go To 
beginning of file, 107, 108 
end of file, 107 
line number, 108 
selected line number, 108 
selection, 108 


H 


HELP, 15, 42, 126 
Hexadecimal digits, see color settings 
Hidden window, 100 


IgnoreCase, 54 
Initialization file, 51-77 
Command Codes, 61 
PT.INI, 52 
INI files, 52 
Menu commands, 67-70 
Mouse Motion, 71-74 
Mouse sensitive window points, 
Insert ASCII character, 38, 92 
Insert character, 29,91 
Insertion point, 13, 91 
Internal buffers, 53 


K 


Keyboard, 
commands, 151 
macro buffer, 123 
Keystroke commands, 151, 152 


L 


Line and column numbers, 85 
Load 

file, 104 

filePattern, 94 


M 


M2ASSIST, 139 

Macro, 121 
keyboard macro buffer, 121 
play back macro, 122 
Begin/End, 53, 122 

MakeBaks, 55 

Match bracket character, 108 


POINT Index 


Menus, 16 
main, 14 
pull-down menus, 17 
Menu commands, 109 
Mouse 
banner line command, 85 
cursor, 44 
driver, 10 
motion, 71-4, 114-116 
sensitive window points, 50,75 
simulation, 45, 47-8 
three button, 44 
two button, 44 
Move, 119 
using the scrap, 33 
without the scrap, 34, 119 
MOVING menu 
Search Backwards, 40, 56 
Search for Selection, 40, 56 
Search for String, 39, 56 


N 


New 
window, 100 
pattem, 94 


O 


Options, 94 
Command Line, 97 
INI options, 53, 59 

OPTIONS menu, 110 
borderColors, 60 
msgColors, 60 
textColors, 60 

OverType, 85, 91 


D - 159 


P 


Play back keyboard macro, 122 
Prompt, 93 
Pull-down menus, 17 


Q 


Quit (command), 124 

QUIT+ETC (Quit Options), 41, 124 
Escape to DOS Shell, 42, 124, 125 
Quit and ask, 41 
Quit and discard, 41, 124 
Quit and save, 41, 124 


R 


Redefine keys, buttons & mouse motion 
commands, 112 
Redo, 120 
undo, 121 
Redraw screen, 42 
RightMargin, 126 


S 


SAVE 

file, 27 

message, 84 

save as..., 27 
Screen, 13 

bottom line, 82-3 

selection, 83 

top line, 82, 83 
Scroll, 25-26, 105-6 
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Search, 56 
backwards, 56, 107 
for selection, 56, 107 
for string, 106 
global, 56 
options, 56 
replace, 107 
SearchMode, 56 
Select 
active window, i9 
end-of-line, 89 
text, 13, 30, 88 
words and lines, 31-3, 89 
Simulate a mouse, 145 


T 


Text insertion, 29 
Thumb, 25 

horizontal, 106 

vertical, 106 
Top, 102 

bottom window, 102 
Top line commands, 109 
Top window, 102 
TOPLIST menu, 22, 110 
TopOnFind, 57 


U 


Undo commands, 57, 120 
erase history, 57,121 
reversible, 57, 121 

UndoBack, 57 

UndoSize, 57 

User-defined menus, 109 


D - 160 


Vv 


VideoMode, 58 
Video attributes, 58 


WwW 


Windows, 18, 19 
active, 22, 
close window, 20, 101 
colors, 101 
corners, 86 
exchange, 103 
hide, 100 
load file, 104 
move, 23, 103 
multiple, 21 
new window, 18, 100 
overlapped, 22 
reshape, 24 
resize, 24, 102 
split window, 101 
stretch, 24, 103 
top, 102 
zoom, 24, 102 
WorkDrive, 58 
Write 
file, 104 


with new name, 104 
Y 
Yes/No questions, 15 
Z 


Zoom window, 102 


Reader’s Critique 


The LOGITECH Publications Department wants you to have manuals that meet your 
needs. Once you use this manual, please take a few moments to answer the a few 
questions. This will help us to provide manuals that you and others can really use. 


Manual: 


Mouse Type: Serial (C7) Bus Series/2 Other 
Mouse Software, Version Number: 


Make and model of computer: 


DOS Version: 
How are we in the following areas? 
(1 = Highest 5 = Lowest) Installation Reference 
Clarity of instructions ae, etal 
Logical organization a en 


Completeness of information 
Usefulness of boldface, italics 
Usefulness of artwork 
Usefulness of screens 
Usefulness of examples 

Ease of finding information 


How much computer experience do you have? 
How would you improve this manual? 


We appreciate any other comments or suggestions you have regarding this manual. 
Please mail your completed card to: 


LOGITECH, Inc. 
Publications Department 
6505 Kaiser Drive 
Fremont, CA 94555 
USA 


LOGITECH, Inc. 
Publications Department 
6505 Kaiser Drive 
Fremont, CA 94555 
USA 


LOGITECH MOUSE 


“The Logitech Bus Mouse and Serial Mouse... have an 
exceptionally good “feel;’ moving smoothly across a 
desktop with just enough friction to allow for precise 
cursor control.” 
PC Magazine Editor’s Choice 
August 1987 


“To sum up my feelings about this mouse and menu 
generating system: this is the one I want.’ 


PC Magazine Editor’s Choice 
January 27, 1987 


“The Logitech Mouse represents a melding of the best 
features of... its major competitors.” 


Jeff Duntemann 
PC Tech Journal 


LOGITECH 


Logitech U.S.A. Logitech Switzerland 
Corporate Headquarters European Headquarters 
6505 Kaiser Drive CH-1111 Romanel/Morges 
Fremont, CA 94555 Switzerland 

Tel: 415-795-8500 Tel: 41-21-869-96-56 
Logitech Taiwan Algol-Logitech Italy 

Far East Headquarters Via Durazzo 2 

15 R&D Road 2 20134 Milano MI 

Science Based Industrial Park __ Italy 

Hsinchu, Taiwan, ROC Tel: 39-2-215-5622 


Tel: 886-3-577-8241 


